aether-colony 5.3.3 → 5.4.0

package/.aether/commands/archaeology.yaml

@@ -306,7 +306,7 @@ body_claude: |
 
   Run using the Bash tool with description "Logging excavation activity...":
   ```bash
-  bash .aether/aether-utils.sh activity-log "ARCHAEOLOGY" "Archaeologist" "Excavated {target}: {total_commits} commits, {author_count} authors, {findings_count} findings, {tech_debt_count} debt markers"
+  aether activity-log "ARCHAEOLOGY" "Archaeologist" "Excavated {target}: {total_commits} commits, {author_count} authors, {findings_count} findings, {tech_debt_count} debt markers"
   ```
 
   Generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
@@ -314,7 +314,7 @@ body_claude: |
   state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
   current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
   total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
-  bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+  aether print-next-up
   ```
 
   ## Investigation Guidelines
@@ -635,7 +635,7 @@ body_opencode: |
   ### Step 8: Log Activity
 
   ```bash
-  bash .aether/aether-utils.sh activity-log "ARCHAEOLOGY" "Archaeologist" "Excavated {target}: {total_commits} commits, {author_count} authors, {findings_count} findings, {tech_debt_count} debt markers"
+  aether activity-log "ARCHAEOLOGY" "Archaeologist" "Excavated {target}: {total_commits} commits, {author_count} authors, {findings_count} findings, {tech_debt_count} debt markers"
   ```
 
   ## Investigation Guidelines

package/.aether/commands/build.yaml

@@ -70,7 +70,7 @@ body_opencode: |
 
   ### Step 0.5: Load Colony State
 
-  Run using Bash tool: `bash .aether/aether-utils.sh load-state`
+  Run using Bash tool: `aether load-state`
 
   If the command fails (non-zero exit or JSON has ok: false):
   1. Parse error JSON
@@ -88,7 +88,7 @@ body_opencode: |
      ```
      (If HANDOFF.md exists, this provides orientation before the build proceeds)
 
-  After displaying context, run: `bash .aether/aether-utils.sh unload-state` to release the lock.
+  After displaying context, run: `aether unload-state` to release the lock.
 
   ### Step 1: Validate + Read State
 
@@ -121,7 +121,7 @@ body_opencode: |
 
   **Set colony depth (if --depth flag provided):**
   If `cli_depth_override` is set:
-  1. Run using Bash tool: `bash .aether/aether-utils.sh colony-depth set "$cli_depth_override"`
+  1. Run using Bash tool: `aether colony-depth set "$cli_depth_override"`
   2. Parse JSON result - if `.ok` is false:
      - Display: `Error: Invalid depth "$cli_depth_override". Use: light, standard, deep, full`
      - Stop here
@@ -150,7 +150,7 @@ body_opencode: |
   Check for unresolved blocker flags on the requested phase:
 
   ```bash
-  bash .aether/aether-utils.sh flag-check-blockers {phase_number}
+  aether flag-check-blockers {phase_number}
   ```
 
   Parse the JSON result (`.result.blockers`):
@@ -158,7 +158,7 @@ body_opencode: |
   - **If blockers == 0:** Display nothing (or optionally a brief `No active blockers for Phase {id}.` line). Proceed to Step 2.
   - **If blockers > 0:** Retrieve blocker details:
     ```bash
-    bash .aether/aether-utils.sh flag-list --type blocker --phase {phase_number}
+    aether flag-list --type blocker --json --phase {phase_number}
     ```
     Parse `.result.flags` and display an advisory warning:
     ```
@@ -219,7 +219,7 @@ body_opencode: |
 
   Run using the Bash tool with description "Showing phase progress...":
   ```bash
-  progress_bar=$(bash .aether/aether-utils.sh generate-progress-bar "$current_phase" "$total_phases" 20 2>/dev/null || echo "")
+  progress_bar=$(aether generate-progress-bar "$current_phase" "$total_phases" 20 2>/dev/null || echo "")
   if [[ -n "$progress_bar" ]]; then
     echo "[Phase ${current_phase}/${total_phases}] ${progress_bar}"
   fi
@@ -246,7 +246,7 @@ body_opencode: |
   Check if territory survey exists and load relevant documents:
 
   ```bash
-  bash .aether/aether-utils.sh survey-load "{phase_name}" 2>/dev/null
+  aether survey-load "{phase_name}" 2>/dev/null
   ```
 
   **Parse the JSON response:**
@@ -292,7 +292,7 @@ body_opencode: |
   Call `queen-read` to extract eternal wisdom for worker priming:
 
   ```bash
-  bash .aether/aether-utils.sh queen-read 2>/dev/null
+  aether queen-read 2>/dev/null
   ```
 
   **Parse the JSON response:**
@@ -327,7 +327,7 @@ body_opencode: |
   Call `pheromone-read` to extract active colony signals for worker priming:
 
   ```bash
-  bash .aether/aether-utils.sh pheromone-read 2>/dev/null
+  aether pheromone-read 2>/dev/null
   ```
 
   **Parse the JSON response:**
@@ -381,8 +381,8 @@ body_opencode: |
 
      Generate archaeologist name and log:
      ```bash
-     bash .aether/aether-utils.sh generate-ant-name "archaeologist"
-     bash .aether/aether-utils.sh spawn-log "Queen" "scout" "{archaeologist_name}" "Pre-build archaeology scan"
+     aether generate-ant-name --caste "archaeologist"
+     aether spawn-log --name "Queen" --caste "scout" --id "{archaeologist_name}" --description "Pre-build archaeology scan"
      ```
 
      Display:
@@ -407,7 +407,7 @@ body_opencode: |
      4. Run: git blame "{file_path}" | head -40 for authorship
      5. Note TODO/FIXME/HACK markers
 
-     Log activity: bash .aether/aether-utils.sh activity-log "READ" "{Ant-Name}" "description"
+     Log activity: aether activity-log "READ" "{Ant-Name}" "description"
 
      Report (plain text):
      - WHY key code sections exist (from commits)
@@ -421,7 +421,7 @@ body_opencode: |
 
      Log completion:
      ```bash
-     bash .aether/aether-utils.sh spawn-complete "{archaeologist_name}" "completed" "Pre-build archaeology scan"
+     aether spawn-complete --id "{archaeologist_name}" --status "completed" --summary "Pre-build archaeology scan"
      ```
 
   3. **Store and display findings:**
@@ -472,9 +472,9 @@ body_opencode: |
 
   3. **Generate ant names for each worker:**
   ```bash
-  bash .aether/aether-utils.sh generate-ant-name "builder"
-  bash .aether/aether-utils.sh generate-ant-name "watcher"
-  bash .aether/aether-utils.sh generate-ant-name "chaos"
+  aether generate-ant-name --caste "builder"
+  aether generate-ant-name --caste "watcher"
+  aether generate-ant-name --caste "chaos"
   ```
 
   Display spawn plan with caste emojis:
@@ -553,12 +553,12 @@ body_opencode: |
 
   **First, mark build start in context:**
   ```bash
-  bash .aether/aether-utils.sh context-update build-start {phase_id} {wave_1_worker_count} {wave_1_task_count}
+  aether context-update build-start {phase_id} {wave_1_worker_count} {wave_1_task_count}
   ```
 
   Before dispatching each worker, refresh colony context so new pheromones/memory are visible:
   ```bash
-  prime_result=$(bash .aether/aether-utils.sh colony-prime --compact 2>/dev/null)
+  prime_result=$(aether colony-prime --compact 2>/dev/null)
   ```
   Update `prompt_section` from `prime_result.result.prompt_section`.
 
@@ -566,8 +566,8 @@ body_opencode: |
 
   Log each spawn and update swarm display:
   ```bash
-  bash .aether/aether-utils.sh spawn-log "Queen" "builder" "{ant_name}" "{task_description}"
-  bash .aether/aether-utils.sh context-update worker-spawn "{ant_name}" "builder" "{task_description}"
+  aether spawn-log --name "Queen" --caste "builder" --id "{ant_name}" --description "{task_description}"
+  aether context-update worker-spawn "{ant_name}" "builder" "{task_description}"
   ```
 
   **Builder Worker Prompt (CLEAN OUTPUT):**
@@ -587,13 +587,13 @@ body_opencode: |
   Work:
   1. Read .aether/workers.md for Builder discipline
   2. Implement task, write tests
-  3. Log activity: bash .aether/aether-utils.sh activity-log "ACTION" "{Ant-Name}" "description"
+  3. Log activity: aether activity-log "ACTION" "{Ant-Name}" "description"
 
   Spawn sub-workers ONLY if 3x complexity:
-  - Check: bash .aether/aether-utils.sh spawn-can-spawn {depth} --enforce
-  - Generate name: bash .aether/aether-utils.sh generate-ant-name "builder"
+  - Check: aether spawn-can-spawn {depth} --enforce
+  - Generate name: aether generate-ant-name --caste "builder"
   - Announce: "🐜 Spawning {child_name} for {reason}"
-  - Log: bash .aether/aether-utils.sh spawn-log "{Ant-Name}" "builder" "{child_name}" "{task}"
+  - Log: aether spawn-log --name "{Ant-Name}" --caste "builder" --id "{child_name}" --description "{task}"
 
   Count your total tool calls (Read + Grep + Edit + Bash + Write) and report as tool_count.
 
@@ -676,7 +676,7 @@ body_opencode: |
 
   Before using any worker payload, validate schema:
   ```bash
-  bash .aether/aether-utils.sh validate-worker-response builder '{worker_json}'
+  aether validate-worker-response builder '{worker_json}'
   ```
   If validation fails, treat the worker as failed with blocker `invalid_worker_response`.
 
@@ -696,8 +696,8 @@ body_opencode: |
 
   Log and update swarm display:
   ```bash
-  bash .aether/aether-utils.sh spawn-complete "{ant_name}" "completed" "{summary}"
-  bash .aether/aether-utils.sh context-update worker-complete "{ant_name}" "completed"
+  aether spawn-complete --id "{ant_name}" --status "completed" --summary "{summary}"
+  aether context-update worker-complete "{ant_name}" "completed"
   ```
 
   **Check for total wave failure:**
@@ -754,7 +754,7 @@ body_opencode: |
 
   Log escalation as flag:
   ```bash
-  bash .aether/aether-utils.sh flag-add "blocker" "{task title}" "{failure summary}" "escalation" {phase_number}
+  aether flag-add --severity "blocker" --title "{task title}" --description "{failure summary}" --source "escalation" --phase {phase_number}
   ```
 
   If at least one worker succeeded, continue normally to the next wave.
@@ -784,7 +784,7 @@ body_opencode: |
   Spawn the Watcher using Task tool with `subagent_type="aether-watcher"`, include `description: "👁️ Watcher {Watcher-Name}: Independent verification"` (DO NOT use run_in_background - task blocks until complete):
 
   ```bash
-  bash .aether/aether-utils.sh spawn-log "Queen" "watcher" "{watcher_name}" "Independent verification"
+  aether spawn-log --name "Queen" --caste "watcher" --id "{watcher_name}" --description "Independent verification"
   ```
 
   **Watcher Worker Prompt (CLEAN OUTPUT):**
@@ -804,7 +804,7 @@ body_opencode: |
   4. Check success criteria: {list}
 
   Spawn sub-workers if needed:
-  - Log: bash .aether/aether-utils.sh spawn-log "{Watcher-Name}" "watcher" "{child}" "{task}"
+  - Log: aether spawn-log --name "{Watcher-Name}" --caste "watcher" --id "{child}" --description "{task}"
   - Announce: "🐜 Spawning {child} to investigate {issue}"
 
   Count your total tool calls (Read + Grep + Edit + Bash + Write) and report as tool_count.
@@ -819,7 +819,7 @@ body_opencode: |
 
   Validate watcher payload first:
   ```bash
-  bash .aether/aether-utils.sh validate-worker-response watcher '{watcher_json}'
+  aether validate-worker-response watcher '{watcher_json}'
   ```
 
   **Parse the Watcher's validated JSON response:** verification_passed, issues_found, quality_score, recommendation
@@ -844,13 +844,13 @@ body_opencode: |
 
   Generate a chaos ant name and log the spawn:
   ```bash
-  bash .aether/aether-utils.sh generate-ant-name "chaos"
-  bash .aether/aether-utils.sh spawn-log "Queen" "chaos" "{chaos_name}" "Resilience testing of Phase {id} work"
+  aether generate-ant-name --caste "chaos"
+  aether spawn-log --name "Queen" --caste "chaos" --id "{chaos_name}" --description "Resilience testing of Phase {id} work"
   ```
 
   **Retrieve existing flags for this phase** (to avoid duplicate findings):
   ```bash
-  bash .aether/aether-utils.sh flag-list --phase {phase_number}
+  aether 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".
 
@@ -901,17 +901,17 @@ body_opencode: |
   If any findings have severity `"critical"` or `"high"`:
   ```bash
   # Create a blocker flag for each critical/high chaos finding
-  bash .aether/aether-utils.sh flag-add "blocker" "{finding.title}" "{finding.description}" "chaos-testing" {phase_number}
+  aether flag-add --severity "blocker" --title "{finding.title}" --description "{finding.description}" --source "chaos-testing" --phase {phase_number}
   ```
 
   Log the flag:
   ```bash
-  bash .aether/aether-utils.sh activity-log "FLAG" "Chaos" "Created blocker: {finding.title}"
+  aether activity-log "FLAG" "Chaos" "Created blocker: {finding.title}"
   ```
 
   Log chaos ant completion and update swarm display:
   ```bash
-  bash .aether/aether-utils.sh spawn-complete "{chaos_name}" "completed" "{summary}"
+  aether spawn-complete --id "{chaos_name}" --status "completed" --summary "{summary}"
   ```
 
   ### Step 5.8: Create Flags for Verification Failures
@@ -921,12 +921,12 @@ body_opencode: |
   For each issue in `issues_found`:
   ```bash
   # Create a blocker flag for each verification failure
-  bash .aether/aether-utils.sh flag-add "blocker" "{issue_title}" "{issue_description}" "verification" {phase_number}
+  aether flag-add --severity "blocker" --title "{issue_title}" --description "{issue_description}" --source "verification" --phase {phase_number}
   ```
 
   Log the flag creation:
   ```bash
-  bash .aether/aether-utils.sh activity-log "FLAG" "Watcher" "Created blocker: {issue_title}"
+  aether activity-log "FLAG" "Watcher" "Created blocker: {issue_title}"
   ```
 
   This ensures verification failures are persisted as blockers that survive context resets. Chaos Ant findings are flagged in Step 5.7.
@@ -1005,11 +1005,11 @@ body_opencode: |
   For each worker that returned `status: "failed"`:
     For each file in that worker's `files_modified` or `files_created`:
   ```bash
-  bash .aether/aether-utils.sh grave-add "{file}" "{ant_name}" "{task_id}" {phase} "{first blocker or summary}"
+  aether grave-add "{file}" "{ant_name}" "{task_id}" {phase} "{first blocker or summary}"
   ```
     Log the grave marker:
   ```bash
-  bash .aether/aether-utils.sh activity-log "GRAVE" "Queen" "Grave marker placed at {file} — {ant_name} failed: {summary}"
+  aether activity-log "GRAVE" "Queen" "Grave marker placed at {file} — {ant_name} failed: {summary}"
   ```
 
   **Error Handoff Update:**
@@ -1184,12 +1184,12 @@ body_opencode: |
   Log this build activity to `.aether/CONTEXT.md`:
 
   ```bash
-  bash .aether/aether-utils.sh context-update activity "build {phase_id}" "{synthesis.status}" "{files_created_count + files_modified_count}"
+  aether context-update activity "build {phase_id}" "{synthesis.status}" "{files_created_count + files_modified_count}"
   ```
 
   Mark build as complete in context:
   ```bash
-  bash .aether/aether-utils.sh context-update build-complete "{synthesis.status}" "{synthesis.status == 'completed' ? 'success' : 'failed'}"
+  aether context-update build-complete "{synthesis.status}" "{synthesis.status == 'completed' ? 'success' : 'failed'}"
   ```
 
   Also update safe-to-clear status:
@@ -1236,7 +1236,7 @@ body_opencode: |
   state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json 2>/dev/null || echo "IDLE")
   current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json 2>/dev/null || echo "0")
   total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json 2>/dev/null || echo "0")
-  bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+  aether print-next-up
   ```
 
   **Routing Note:** The state-based Next Up block above routes based on colony state. If verification failed or blockers exist, review `/ant:flags` before continuing.
@@ -1251,6 +1251,6 @@ body_opencode: |
   Update the session tracking file to enable `/ant:resume` after context clear:
 
   ```bash
-  bash .aether/aether-utils.sh session-update "/ant:build {phase_id}" "/ant:continue" "Phase {phase_id} build completed: {synthesis.status}"
+  aether session-update --command "/ant:build {phase_id}" --worker "/ant:continue" --summary "Phase {phase_id} build completed: {synthesis.status}"
   ```
 

package/.aether/commands/chaos.yaml

@@ -292,12 +292,12 @@ body_claude: |
 
   ```bash
   # For each scenario where status == "finding" AND severity is "CRITICAL" or "HIGH":
-  bash .aether/aether-utils.sh flag-add "blocker" "{scenario.title}" "{scenario.description}" "chaos-standalone" {current_phase_number}
+  aether flag-add --severity "blocker" --title "{scenario.title}" --description "{scenario.description}" --source "chaos-standalone" --phase {current_phase_number}
   ```
 
   Log each flag creation by running using the Bash tool with description "Logging chaos flag...":
   ```bash
-  bash .aether/aether-utils.sh activity-log "FLAG" "Chaos Ant" "Created blocker: {scenario.title}"
+  aether activity-log "FLAG" "Chaos Ant" "Created blocker: {scenario.title}"
   ```
 
   The `{current_phase_number}` comes from the colony state loaded in Step 1 (`.aether/data/COLONY_STATE.json` field `current_phase`).
@@ -308,7 +308,7 @@ body_claude: |
 
   Run using the Bash tool with description "Logging chaos activity...":
   ```bash
-  bash .aether/aether-utils.sh activity-log "CHAOS" "Chaos Ant" "Resilience test on {target}: {findings_count} finding(s) ({critical} critical, {high} high, {medium} medium, {low} low), {resilient_count} resilient"
+  aether activity-log "CHAOS" "Chaos Ant" "Resilience test on {target}: {findings_count} finding(s) ({critical} critical, {high} high, {medium} medium, {low} low), {resilient_count} resilient"
   ```
 
   Generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
@@ -316,7 +316,7 @@ body_claude: |
   state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
   current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
   total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
-  bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+  aether print-next-up
   ```
 
   ## Investigation Guidelines
@@ -620,12 +620,12 @@ body_opencode: |
 
   ```bash
   # For each scenario where status == "finding" AND severity is "CRITICAL" or "HIGH":
-  bash .aether/aether-utils.sh flag-add "blocker" "{scenario.title}" "{scenario.description}" "chaos-standalone" {current_phase_number}
+  aether flag-add --severity "blocker" --title "{scenario.title}" --description "{scenario.description}" --source "chaos-standalone" --phase {current_phase_number}
   ```
 
   Log each flag creation:
   ```bash
-  bash .aether/aether-utils.sh activity-log "FLAG" "Chaos Ant" "Created blocker: {scenario.title}"
+  aether activity-log "FLAG" "Chaos Ant" "Created blocker: {scenario.title}"
   ```
 
   The `{current_phase_number}` comes from the colony state loaded in Step 1 (`.aether/data/COLONY_STATE.json` field `current_phase`).
@@ -635,7 +635,7 @@ body_opencode: |
   ### Step 7: Log Activity
 
   ```bash
-  bash .aether/aether-utils.sh activity-log "CHAOS" "Chaos Ant" "Resilience test on {target}: {findings_count} finding(s) ({critical} critical, {high} high, {medium} medium, {low} low), {resilient_count} resilient"
+  aether activity-log "CHAOS" "Chaos Ant" "Resilience test on {target}: {findings_count} finding(s) ({critical} critical, {high} high, {medium} medium, {low} low), {resilient_count} resilient"
   ```
 
   ## Investigation Guidelines

package/.aether/commands/colonize.yaml

@@ -106,14 +106,14 @@ body_claude: |
   SURVEY_START=$(date +%s)
 
   # Check for stale survey files
-  stale_check=$(bash .aether/aether-utils.sh session-verify-fresh --command survey "" "$SURVEY_START")
+  stale_check=$(aether session-verify-fresh --command survey "" "$SURVEY_START")
   has_stale=$(echo "$stale_check" | jq -r '.stale | length')
   has_fresh=$(echo "$stale_check" | jq -r '.fresh | length')
 
   if [[ "$has_stale" -gt 0 ]] || [[ "$has_fresh" -gt 0 ]]; then
     # Found existing survey files
     if [[ "$force_resurvey" == "true" ]]; then
-      bash .aether/aether-utils.sh session-clear --command survey
+      aether session-clear --command survey
       echo "Cleared existing survey files for fresh territory mapping"
     else
       echo "Found existing territory survey. Use --force-resurvey to remap."
@@ -124,15 +124,15 @@ body_claude: |
 
   Generate unique names for the 4 Surveyor Ants (each name must be captured separately):
   ```bash
-   bash .aether/aether-utils.sh generate-ant-name "surveyor"
-  bash .aether/aether-utils.sh generate-ant-name "surveyor"
-  bash .aether/aether-utils.sh generate-ant-name "surveyor"
-  bash .aether/aether-utils.sh generate-ant-name "surveyor"
+   aether generate-ant-name --caste "surveyor"
+  aether generate-ant-name --caste "surveyor"
+  aether generate-ant-name --caste "surveyor"
+  aether generate-ant-name --caste "surveyor"
   ```
 
   Log the dispatches (consolidated - fire-and-forget logging):
   ```bash
-  bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{provisions_name}" "Mapping provisions and trails" && bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{nest_name}" "Mapping nest structure" && bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{disciplines_name}" "Mapping disciplines and sentinels" && bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{pathogens_name}" "Identifying pathogens"
+  aether spawn-log --name "Queen" --caste "surveyor" --id "{provisions_name}" --description "Mapping provisions and trails" && aether spawn-log --name "Queen" --caste "surveyor" --id "{nest_name}" --description "Mapping nest structure" && aether spawn-log --name "Queen" --caste "surveyor" --id "{disciplines_name}" --description "Mapping disciplines and sentinels" && aether spawn-log --name "Queen" --caste "surveyor" --id "{pathogens_name}" --description "Identifying pathogens"
   ```
 
   **Spawn 4 Surveyor Ants in parallel using the Task tool:**
@@ -176,7 +176,7 @@ body_claude: |
 
   Verify that all survey files were created after the session start:
   ```bash
-  verify_result=$(bash .aether/aether-utils.sh session-verify-fresh --command survey "" "$SURVEY_START")
+  verify_result=$(aether session-verify-fresh --command survey "" "$SURVEY_START")
   fresh_count=$(echo "$verify_result" | jq -r '.fresh | length')
 
   if [[ "$fresh_count" -lt 7 ]]; then
@@ -252,7 +252,7 @@ body_claude: |
   state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
   current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
   total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
-  bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+  aether print-next-up
   ```
 
 body_opencode: |
@@ -323,18 +323,18 @@ body_opencode: |
 
   Generate unique names for the 4 Surveyor Ants and log their dispatch:
   ```bash
-  bash .aether/aether-utils.sh generate-ant-name "surveyor"
-  bash .aether/aether-utils.sh generate-ant-name "surveyor"
-  bash .aether/aether-utils.sh generate-ant-name "surveyor"
-  bash .aether/aether-utils.sh generate-ant-name "surveyor"
+  aether generate-ant-name --caste "surveyor"
+  aether generate-ant-name --caste "surveyor"
+  aether generate-ant-name --caste "surveyor"
+  aether generate-ant-name --caste "surveyor"
   ```
 
   Log the dispatch:
   ```bash
-  bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{provisions_name}" "Mapping provisions and trails"
-  bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{nest_name}" "Mapping nest structure"
-  bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{disciplines_name}" "Mapping disciplines and sentinels"
-  bash .aether/aether-utils.sh spawn-log "Queen" "surveyor" "{pathogens_name}" "Identifying pathogens"
+  aether spawn-log --name "Queen" --caste "surveyor" --id "{provisions_name}" --description "Mapping provisions and trails"
+  aether spawn-log --name "Queen" --caste "surveyor" --id "{nest_name}" --description "Mapping nest structure"
+  aether spawn-log --name "Queen" --caste "surveyor" --id "{disciplines_name}" --description "Mapping disciplines and sentinels"
+  aether spawn-log --name "Queen" --caste "surveyor" --id "{pathogens_name}" --description "Identifying pathogens"
   ```
 
   **Spawn 4 Surveyor Ants in parallel using the Task tool:**