aether-colony 3.1.0 → 3.1.1

package/.aether/visualizations/anthill-stages/brood-stable.txt

@@ -0,0 +1,26 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+         🥚  🥚              🥚  🥚
+              .      .      .      .
+             /|\    /|\    /|\    /|\
+            / | \  / | \  / | \  / | \
+           /  |  \/  |  \/  |  \/  |  \
+          /   |   /\  |   /\  |   /\  |   \
+         /____|__/___\|___/___\|___/___\|____\
+        /  o   /  o   \  o   /  o   \  o   \
+       /______/_______\_____/_______\_______\
+      /_______________________________________\
+     /_________________________________________\
+    /___________________________________________\
+   /_____________________________________________\
+  /_______________________________________________\
+
+🐜🐜🐜 Brood chamber thriving...
+   New life stirs in the nursery,
+   the colony's future secured.
+
+Milestone: Brood Stable
+Phases: 4-6 completed
+Colony Age: Established

package/.aether/visualizations/anthill-stages/crowned-anthill.txt

@@ -0,0 +1,30 @@
+                        👑
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              ✨         ✨         ✨
+         🥚  🥚  🥚  🥚  🥚  🥚  🥚  🥚  🥚
+    .      .      .      .      .      .      .      .
+   /|\    /|\    /|\    /|\    /|\    /|\    /|\    /|\
+  / | \  / | \  / | \  / | \  / | \  / | \  / | \  / | \
+ /  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \
+/   |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   \
+\___|___/___\|___/___\|___/___\|___/___\|___/___\|___/___\|___/___\|___/___/
+ \  o   /  o   \  o   /  o   \  o   /  o   \  o   /  o   /
+  \____/_______\_____/_______\_____/_______\_____/_______/
+   \_______________________________________________________/
+    \_______________________________________________________\
+     \_______________________________________________________\
+      \_______________________________________________________\
+       \_______________________________________________________\
+        \_______________________________________________________\
+         \_______________________________________________________\
+
+🐜🐜🐜🐜🐜🐜 The Crowned Anthill!
+   A monument to collective effort,
+   the colony stands supreme.
+
+Milestone: Crowned Anthill
+Phases: 15+ completed
+Colony Age: Legendary

package/.aether/visualizations/anthill-stages/first-mound.txt

@@ -0,0 +1,18 @@
+              .      .
+             /|\    /|\
+            / | \  / | \
+           /  |  \/  |  \
+          /   |   /\  |   \
+         /____|__/___\|____\
+        /      /     \      \
+       /______/_______\______\
+      /________________________\
+     /__________________________\
+
+🐜 A humble beginning...
+   Just a small mound of earth,
+   but full of potential.
+
+Milestone: First Mound
+Phases: 0 completed
+Colony Age: Newborn

package/.aether/visualizations/anthill-stages/open-chambers.txt

@@ -0,0 +1,24 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              .      .      .
+             /|\    /|\    /|\
+            / | \  / | \  / | \
+           /  |  \/  |  \/  |  \
+          /   |   /\  |   /\  |   \
+         /____|__/___\|___/___\|____\
+        /  o   /  o   \  o   /  o   \
+       /______/_______\_____/_______\
+      /_______________________________\
+     /_________________________________\
+    /___________________________________\
+   /_____________________________________\
+
+🐜🐜 Tunnels open...
+   The colony expands its reach,
+   chambers forming beneath the earth.
+
+Milestone: Open Chambers
+Phases: 1-3 completed
+Colony Age: Growing

package/.aether/visualizations/anthill-stages/sealed-chambers.txt

@@ -0,0 +1,28 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              🔒         🔒
+         🥚  🥚  🥚  🥚  🥚  🥚  🥚
+    .      .      .      .      .      .      .
+   /|\    /|\    /|\    /|\    /|\    /|\    /|\
+  / | \  / | \  / | \  / | \  / | \  / | \  / | \
+ /  |  \/  |  \/  |  \/  |  \/  |  \/  |  \/  |  \
+/   |   /\  |   /\  |   /\  |   /\  |   /\  |   /\  |   \
+\___|___/___\|___/___\|___/___\|___/___\|___/___\|___/___/
+ \  o   /  o   \  o   /  o   \  o   /  o   \  o   /
+  \____/_______\_____/_______\_____/_______\_____/
+   \_______________________________________________/
+    \_______________________________________________\
+     \_______________________________________________\
+      \_______________________________________________\
+       \_______________________________________________\
+        \_______________________________________________\
+
+🐜🐜🐜🐜🐜 Chambers sealed...
+   Fortified against the outside world,
+   treasures protected, secrets kept.
+
+Milestone: Sealed Chambers
+Phases: 11-14 completed
+Colony Age: Seasoned

package/.aether/visualizations/anthill-stages/ventilated-nest.txt

@@ -0,0 +1,27 @@
+                    .-.
+                   (o o)
+                   | O |
+                    `-`
+              🌬️         🌬️
+         🥚  🥚  🥚      🥚  🥚  🥚
+    .      .      .      .      .      .
+   /|\    /|\    /|\    /|\    /|\    /|\
+  / | \  / | \  / | \  / | \  / | \  / | \
+ /  |  \/  |  \/  |  \/  |  \/  |  \/  |  \
+/   |   /\  |   /\  |   /\  |   /\  |   /\  |   \
+\___|___/___\|___/___\|___/___\|___/___\|___/___/
+ \  o   /  o   \  o   /  o   \  o   /  o   /
+  \____/_______\_____/_______\_____/_______/
+   \_________________________________________/
+    \_________________________________________\
+     \_________________________________________\
+      \_________________________________________\
+       \_________________________________________\
+
+🐜🐜🐜🐜 Air flows through...
+   Complex passages ventilate the nest,
+   workers move with purpose and speed.
+
+Milestone: Ventilated Nest
+Phases: 7-10 completed
+Colony Age: Mature

package/.claude/commands/ant/build.md

@@ -217,7 +217,7 @@ CONSTRAINTS: (none)
       Scanning history of files to be modified...
    ```
 
-   Spawn a Scout (using Task tool with `subagent_type="general-purpose"`) with this prompt:
+   Spawn a Scout (using Task tool with `subagent_type="general"`) with this prompt:
 
    ```
    You are {Archaeologist-Name}, a 🏺 Archaeologist Ant (Scout) in the Aether Colony.
@@ -236,6 +236,10 @@ CONSTRAINTS: (none)
    4. Run: git blame "{file_path}" | head -40 to see authorship of key sections
    5. Note any TODO/FIXME/HACK markers in the current code
 
+   --- MODEL CONTEXT ---
+   Assigned model: {model} (from caste: archaeologist)
+   This ant is running as: {Ant-Name} (archaeologist caste)
+
    --- OUTPUT ---
    For each file, report:
    - WHY key code sections exist (from commit messages)
@@ -244,6 +248,9 @@ CONSTRAINTS: (none)
    - Areas of caution (high churn, reverted changes, emergency fixes)
    - Sections that are stable bedrock vs volatile sand
 
+   Include in your header:
+   Model: {model} | Caste: archaeologist | Ant: {Ant-Name}
+
    Keep the report concise and actionable — builders need quick context, not a thesis.
    Format as plain text with file headers. No JSON output needed.
    ```
@@ -321,56 +328,13 @@ Total: {N} Builders + 1 Watcher + 1 Chaos = {N+2} spawns
 
 **CRITICAL: Spawn ALL Wave 1 workers in a SINGLE message using multiple Task tool calls.**
 
-For each Wave 1 task, use Task tool with `subagent_type="general-purpose"` and `run_in_background: true`:
+For each Wave 1 task, use Task tool with `subagent_type="general"` and `run_in_background: true`:
 
 Log each spawn:
 ```bash
 bash .aether/aether-utils.sh spawn-log "Queen" "builder" "{ant_name}" "{task_description}"
 ```
 
-**Model Assignment:**
-
-Before spawning each worker, get the optimal model for their caste with task-based routing:
-
-```bash
-# Get model assignment for this caste with task-based routing
-model_info=$(bash .aether/aether-utils.sh model-profile select "{caste}" "{task_description}" "{cli_model_override}")
-model=$(echo "$model_info" | jq -r '.result.model')
-source=$(echo "$model_info" | jq -r '.result.source')
-
-# Log model assignment with source
-bash .aether/aether-utils.sh activity-log "MODEL" "Queen" "{ant_name} ({caste}): assigned to $model (source: $source)"
-```
-
-**Environment Setup for Workers:**
-
-When spawning workers, the following environment variables must be set for Claude Code to use the LiteLLM proxy with the correct model:
-
-```bash
-export ANTHROPIC_BASE_URL="http://localhost:4000"
-export ANTHROPIC_AUTH_TOKEN="sk-litellm-local"
-export ANTHROPIC_MODEL="$model"  # From model-profile get above
-```
-
-**IMPORTANT:** The Task tool inherits environment from the parent Claude Code process. Set these variables in the shell before spawning workers, or ensure they are already set in the parent environment.
-
-### Step 5.1.5: Export Model Environment
-
-Before spawning workers, export the environment variables for LiteLLM proxy routing:
-
-```bash
-export ANTHROPIC_BASE_URL="http://localhost:4000"
-export ANTHROPIC_AUTH_TOKEN="sk-litellm-local"
-```
-
-For each worker spawn, also export their specific model:
-
-```bash
-export ANTHROPIC_MODEL="$model"  # From model-profile get
-```
-
-**Note:** These environment variables will be inherited by spawned workers via the Task tool, enabling automatic model routing through the LiteLLM proxy.
-
 **Builder Worker Prompt Template:**
 ```
 You are {Ant-Name}, a 🔨 Builder Ant in the Aether Colony at depth {depth}.
@@ -378,16 +342,6 @@ You are {Ant-Name}, a 🔨 Builder Ant in the Aether Colony at depth {depth}.
 --- YOUR TASK ---
 Task {id}: {description}
 
---- MODEL CONTEXT ---
-Optimal model for this task: {model} (from caste: {caste})
-Model characteristics: {model_description}
-Task complexity expectation: {simple|medium|complex}
-
-The model has been pre-selected based on your caste's typical work patterns.
-- glm-5: Use for complex reasoning, architecture, planning
-- kimi-k2.5: Use for fast implementation, coding, refactoring
-- minimax-2.5: Use for validation, research, quick checks
-
 --- CONTEXT ---
 Goal: "{colony_goal}"
 Phase: {phase_name}
@@ -449,7 +403,7 @@ Before spawning:
   1. Check: bash .aether/aether-utils.sh spawn-can-spawn {depth}
   2. Generate name: bash .aether/aether-utils.sh generate-ant-name "{caste}"
   3. Log: bash .aether/aether-utils.sh spawn-log "{your_name}" "{caste}" "{child_name}" "{task}"
-  4. Use Task tool with subagent_type="general-purpose"
+  4. Use Task tool with subagent_type="general"
   5. After completion: bash .aether/aether-utils.sh spawn-complete "{child_name}" "{status}" "{summary}"
 
 Full spawn format: .aether/workers.md section "Spawning Sub-Workers"
@@ -465,7 +419,13 @@ Return JSON:
   "files_modified": [],
   "tests_written": [],
   "blockers": [],
-  "spawns": []
+  "spawns": [],
+  "model_context": {
+    "assigned": "{model}",
+    "caste": "builder",
+    "source": "caste-default",
+    "reported_at": "ISO-8601 timestamp"
+  }
 }
 ```
 
@@ -588,7 +548,13 @@ Return JSON:
   "issues_found": [],
   "quality_score": N,
   "recommendation": "proceed" | "fix_required",
-  "spawns": []
+  "spawns": [],
+  "model_context": {
+    "assigned": "{model}",
+    "caste": "watcher",
+    "source": "caste-default",
+    "reported_at": "ISO-8601 timestamp"
+  }
 }
 ```
 
@@ -619,7 +585,7 @@ bash .aether/aether-utils.sh flag-list --phase {phase_number}
 ```
 Parse the result and extract unresolved flag titles into a list: `{existing_flag_titles}` (comma-separated titles from `.result.flags[].title`). If no flags exist, set `{existing_flag_titles}` to "None".
 
-Spawn the Chaos Ant using Task tool with `subagent_type="general-purpose"`:
+Spawn the Chaos Ant using Task tool with `subagent_type="general"`:
 
 **Chaos Ant Prompt:**
 ```
@@ -666,7 +632,13 @@ Return JSON:
     }
   ],
   "overall_resilience": "strong|moderate|weak",
-  "summary": "..."
+  "summary": "...",
+  "model_context": {
+    "assigned": "{model}",
+    "caste": "chaos",
+    "source": "caste-default",
+    "reported_at": "ISO-8601 timestamp"
+  }
 }
 ```
 
@@ -930,6 +902,12 @@ Display build summary based on synthesis results AND `verbose_mode` from Step 1:
 🔧 Debugging: {debugging.issues_resolved}/{debugging.issues_encountered} resolved
 {end if}
 
+🤖 Model Routing:
+{for each spawn in spawn_tree where model_context exists:}
+   {caste_emoji}{ant_name}: {model_context.assigned} {if model_context.assigned matches caste expectation:}✓{else}⚠️{end if}
+{end for}
+   Proxy: {if proxy_healthy:}✓ Healthy @ http://localhost:4000{else}✗ Not running (using default model){end if}
+
 🐜 Next Steps:
 {if synthesis.status == "completed" AND verification.recommendation == "proceed":}
    /ant:continue   ➡️  Advance to next phase

package/.claude/commands/ant/continue.md

@@ -42,10 +42,10 @@ If successful and goal is not null:
    🔄 Resuming: Phase X - Name
    ```
 
-If HANDOFF.md exists (detected in load-state output):
+If .aether/HANDOFF.md exists (detected in load-state output):
 - Display "Resuming from paused session"
-- Read HANDOFF.md for additional context
-- Remove HANDOFF.md after display (cleanup)
+- Read .aether/HANDOFF.md for additional context
+- Remove .aether/HANDOFF.md after display (cleanup)
 
 Run: `bash .aether/aether-utils.sh unload-state` to release lock.
 

package/.claude/commands/ant/organize.md

@@ -48,7 +48,7 @@ If no active signals after filtering:
 
 Read `.aether/workers.md` and extract the `## Architect` section.
 
-Spawn via **Task tool** with `subagent_type="general-purpose"`:
+Spawn via **Task tool** with `subagent_type="general"`:
 
 ```
 --- WORKER SPEC ---

package/.claude/commands/ant/pause-colony.md

@@ -69,7 +69,7 @@ Run `/ant:resume-colony` in a new session.
 <what should happen next>
 ```
 
-### Step 4.6: Set Paused Flag in State
+### Step 4.5: Set Paused Flag in State
 
 Use Read tool to get current COLONY_STATE.json.
 
@@ -80,7 +80,7 @@ Use Write tool to update COLONY_STATE.json with paused flag:
 
 This flag indicates the colony is in a paused state and will be cleared on resume.
 
-### Step 4.5: Commit Suggestion (Optional)
+### Step 4.6: Commit Suggestion (Optional)
 
 **This step is non-blocking. Skipping does not affect the pause or any subsequent steps. Failure to commit has zero consequences.**
 

package/.claude/commands/ant/plan.md

@@ -44,10 +44,10 @@ If successful and goal is not null:
    🔄 Resuming: Phase X - Name
    ```
 
-If HANDOFF.md exists (detected in load-state output):
+If .aether/HANDOFF.md exists (detected in load-state output):
 - Display "Resuming from paused session"
-- Read HANDOFF.md for additional context
-- Remove HANDOFF.md after display (cleanup)
+- Read .aether/HANDOFF.md for additional context
+- Remove .aether/HANDOFF.md after display (cleanup)
 
 Run: `bash .aether/aether-utils.sh unload-state` to release lock.
 
@@ -123,7 +123,7 @@ while iteration < 50 AND confidence < 95:
 
     # === RESEARCH PHASE ===
 
-    Spawn Research Ant (Scout) via Task tool with subagent_type="general-purpose":
+    Spawn Research Ant (Scout) via Task tool with subagent_type="general":
 
     """
     You are a Scout Ant in the Aether Colony.
@@ -173,7 +173,7 @@ while iteration < 50 AND confidence < 95:
 
     # === PLANNING PHASE ===
 
-    Spawn Planning Ant (Route-Setter) via Task tool with subagent_type="general-purpose":
+    Spawn Planning Ant (Route-Setter) via Task tool with subagent_type="general":
 
     """
     You are a Route-Setter Ant in the Aether Colony.

package/.claude/commands/ant/resume-colony.md

@@ -47,7 +47,7 @@ Output header:
 ═══════════════════════════════════════════════════ 🚦➡️🐜💨💨
 ```
 
-Read the HANDOFF.md for context about what was happening, then display:
+Read the .aether/HANDOFF.md for context about what was happening, then display:
 
 ```
 +=====================================================+
@@ -67,23 +67,12 @@ ACTIVE PHEROMONES
 
   If no active signals: (no active pheromones)
 
-WORKERS
-
-  If ALL workers have "idle" status, display:
-    All 6 workers idle -- colony ready
-
-  Otherwise, group by status with caste name:
-    Active:
-      builder: currently executing
-    Idle:
-      colonizer  route-setter  watcher  scout  architect
-
 PHASE PROGRESS
   Phase <id>: <name> [<status>]
   (list all phases from plan.phases)
 
 CONTEXT FROM HANDOFF
-  <summarize what was happening from HANDOFF.md>
+  <summarize what was happening from .aether/HANDOFF.md>
 
 NEXT ACTIONS
 ```

package/.claude/commands/ant/status.md

@@ -63,11 +63,11 @@ If successful and goal is not null:
       Last activity: timestamp
    ```
 
-5. Check for HANDOFF.md existence in the load-state output or via separate check
-6. If HANDOFF.md exists:
+5. Check for .aether/HANDOFF.md existence in the load-state output or via separate check
+6. If .aether/HANDOFF.md exists:
    - Display: "Resuming from paused session"
-   - Read HANDOFF.md content for additional context
-   - Remove HANDOFF.md after displaying (cleanup)
+   - Read .aether/HANDOFF.md content for additional context
+   - Remove .aether/HANDOFF.md after displaying (cleanup)
 
 Run: `bash .aether/aether-utils.sh unload-state` to release lock.
 

package/.claude/commands/ant/verify-castes.md

@@ -1,95 +1,85 @@
 ---
 name: ant:verify-castes
-description: "Verify model routing is working for all castes"
+description: "Verify colony caste assignments and system status"
 ---
 
-You are the **Queen**. Verify that model routing is active and working.
+You are the **Queen**. Display the caste assignments and system status.
 
-## Step 1: Check Proxy Health
+## Step 1: Show Caste Assignments
 
-Run using the Bash tool: `node bin/cli.js caste-models list`
+Display the colony caste structure:
 
-Capture the proxy status line. If proxy is unhealthy:
-- Display warning about proxy not running
-- Show instructions to start LiteLLM proxy
-- Continue with verification anyway (will show failures)
-
-## Step 2: Verify Each Caste Assignment
-
-For each caste in [prime, builder, watcher, oracle, scout, chaos, architect, archaeologist, colonizer, route_setter]:
-
-1. Get assigned model using the Bash tool:
-   ```
-   node -e "const mp = require('./bin/lib/model-profiles'); const p = mp.loadModelProfiles('.'); console.log(mp.getEffectiveModel(p, 'CASTE').model)"
-   ```
-   Replace CASTE with the actual caste name.
-
-2. Verify model is not "default" (should be specific model from profiles)
-3. Log result with checkmark or X
-
-Display results in a table:
-```
-Caste Verification:
-─────────────────────────────────────────
-✓ prime: glm-5 (z_ai)
-✓ builder: kimi-k2.5 (kimi)
-✓ watcher: kimi-k2.5 (kimi)
-...
 ```
+Aether Colony Caste System
+═══════════════════════════════════════════
 
-## Step 3: Test Spawn Verification (Optional but Recommended)
+CASTE ASSIGNMENTS
+─────────────────
+👑 Prime           - Colony coordination and strategic planning
+🏺 Archaeologist   - Git history analysis and pattern excavation
+🏛️ Architect      - System design and documentation
+🔮 Oracle          - Deep research and foresight
+🗺️ Route Setter    - Task decomposition and planning
+🔨 Builder         - Implementation and coding
+👁️ Watcher         - Verification and testing
+🔍 Scout           - Research and exploration
+🎲 Chaos           - Edge case testing and resilience probing
+🧭 Colonizer       - Environment setup and exploration
+
+───────────────────────────────────────────
+```
 
-If proxy is healthy, spawn a test worker to verify model routing actually works:
+## Step 2: Check System Status
 
-1. Create a temporary test script that:
-   - Reports which ANTHROPIC_MODEL it sees
-   - Reports ANTHROPIC_BASE_URL
-   - Exits successfully
+Run using Bash tool: `bash .aether/aether-utils.sh version-check 2>/dev/null || echo "Utils available"`
 
-2. Use the Write tool to create a temporary test script at `/tmp/aether-test-spawn.js`:
-```javascript
-console.log('ANTHROPIC_MODEL:', process.env.ANTHROPIC_MODEL || '(not set)');
-console.log('ANTHROPIC_BASE_URL:', process.env.ANTHROPIC_BASE_URL || '(not set)');
-process.exit(0);
+Check LiteLLM proxy status:
+```bash
+curl -s http://localhost:4000/health 2>/dev/null | grep -q "healthy" && echo "✓ Proxy healthy" || echo "⚠ Proxy not running"
 ```
 
-3. Spawn test worker via Task tool with builder caste environment variables:
-   - Set ANTHROPIC_MODEL to the builder's assigned model
-   - Set ANTHROPIC_BASE_URL to the proxy endpoint
-
-4. Capture output and verify:
-   - Model environment variable is set correctly
-   - Base URL points to proxy
+## Step 3: Show Current Session Info
 
-5. Display result:
 ```
-Test Spawn (builder):
-─────────────────────────────────────────
-Model: kimi-k2.5 ✓
-Base URL: http://localhost:4000 ✓
+SESSION INFORMATION
+───────────────────
+All workers in this session use the same model configuration.
+To change models, restart Claude Code with different settings:
+
+export ANTHROPIC_BASE_URL=http://localhost:4000
+export ANTHROPIC_AUTH_TOKEN=sk-litellm-local
+export ANTHROPIC_MODEL=<model-name>
+claude
+
+Available models (via LiteLLM proxy):
+  • glm-5        - Complex reasoning, architecture, planning
+  • kimi-k2.5    - Fast coding, implementation
+  • minimax-2.5  - Validation, research, exploration
 ```
 
-## Step 4: Summary Report
+## Step 4: Summary
 
-Display final verification report:
 ```
 ═══════════════════════════════════════════
-Verification Complete
+System Status
 ═══════════════════════════════════════════
-Proxy Health: ✓ Healthy
-Caste Assignments: 10/10 verified
-Test Spawn: ✓ Working
-
-Status: All systems operational
+Utils: ✓ Operational
+Proxy: {status from Step 2}
+Castes: 10 defined
+
+Note: Model-per-caste routing was attempted but is not
+possible with Claude Code's Task tool (no env var support).
+See archived config: .aether/archive/model-routing/
+Tag: model-routing-v1-archived
 ```
 
-Or if issues found:
-```
-Issues Detected:
-- Proxy unhealthy (not running)
-- 3 castes using default model
+## Historical Note
+
+A model-per-caste system was designed and implemented but cannot
+function due to Claude Code Task tool limitations. The complete
+configuration is archived in `.aether/archive/model-routing/`.
 
-Recommendations:
-1. Start LiteLLM proxy: litellm --config proxy.yaml
-2. Run `aether caste-models set <caste>=<model>` for missing assignments
+To view the archived configuration:
+```bash
+git show model-routing-v1-archived
 ```