aether-colony 5.3.2 → 5.4.0

package/.aether/commands/plan.yaml

@@ -36,7 +36,7 @@ body_claude: |
 
   ### Step 1.5: Load State and Show Resumption Context
 
-  Run using Bash tool: `bash .aether/aether-utils.sh load-state`
+  Run using Bash tool: `aether load-state`
 
   If successful and goal is not null:
   1. Extract current_phase from state
@@ -51,7 +51,7 @@ body_claude: |
   - 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.
+  Run: `aether unload-state` to release lock.
 
   **Error handling:**
   - If E_FILE_NOT_FOUND: "No colony initialized. Run /ant:init first." and stop
@@ -87,7 +87,7 @@ body_claude: |
 
   Run using the Bash tool with description "Loading compact planning context...":
   ```bash
-  bash .aether/aether-utils.sh context-capsule --compact --json 2>/dev/null
+  aether context-capsule --compact --json 2>/dev/null
   ```
 
   If JSON is valid and `.ok == true`, extract `.result.prompt_section` into `context_capsule_prompt`.
@@ -169,7 +169,7 @@ body_claude: |
   **1. Retrieve hive wisdom for research priming:**
 
   ```bash
-  hive_context=$(bash .aether/aether-utils.sh hive-read --limit 5 --format text 2>/dev/null)
+  hive_context=$(aether hive-read --limit 5 --format text 2>/dev/null)
   ```
 
   Parse the JSON result to extract `.result.text` as `hive_text`. If command fails or returns empty, set `hive_text = ""`.
@@ -571,7 +571,7 @@ body_claude: |
     echo "ERROR: Plan write verification failed (phases=$verify_phases, generated_at=$verify_timestamp, state=$verify_state)"
     echo "Attempting retry write..."
     # Retry: re-read, update, write via state API
-    bash .aether/aether-utils.sh state-write "$(jq --argjson phases "$(echo '$PLAN_JSON' | jq '.plan.phases')" --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '.plan.phases = $phases | .plan.generated_at = $ts | .state = "READY"' .aether/data/COLONY_STATE.json)"
+    aether state-write "$(jq --argjson phases "$(echo '$PLAN_JSON' | jq '.plan.phases')" --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '.plan.phases = $phases | .plan.generated_at = $ts | .state = "READY"' .aether/data/COLONY_STATE.json)"
     verify_phases=$(jq '.plan.phases | length' .aether/data/COLONY_STATE.json)
     if [[ "$verify_phases" -lt 1 ]]; then
       echo "FATAL: Retry write also failed. Plan was not persisted."
@@ -582,7 +582,7 @@ body_claude: |
   echo "Plan verified: $verify_phases phases, generated_at=$verify_timestamp, state=$verify_state"
   ```
 
-  Log: `bash .aether/aether-utils.sh activity-log "PLAN_COMPLETE" "queen" "Plan finalized with {confidence}% confidence"`
+  Log: `aether activity-log "PLAN_COMPLETE" "queen" "Plan finalized with {confidence}% confidence"`
 
   Update watch-status.txt:
   ```
@@ -601,7 +601,7 @@ body_claude: |
   Update the session tracking file to enable `/ant:resume` after context clear:
 
   ```bash
-  bash .aether/aether-utils.sh session-update "/ant:plan" "/ant:build 1" "Plan generated with {confidence}% confidence, {N} phases"
+  aether session-update --command "/ant:plan" --worker "/ant:build 1" --summary "Plan generated with {confidence}% confidence, {N} phases"
   ```
 
   ### Step 7: Display Plan
@@ -650,7 +650,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
   ```
 
   ---
@@ -725,7 +725,7 @@ body_opencode: |
 
   ### Step 1.5: Load State and Show Resumption Context
 
-  Run using Bash tool: `bash .aether/aether-utils.sh load-state`
+  Run using Bash tool: `aether load-state`
 
   If successful and goal is not null:
   1. Extract current_phase from state
@@ -740,7 +740,7 @@ body_opencode: |
   - 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.
+  Run: `aether unload-state` to release lock.
 
   **Error handling:**
   - If E_FILE_NOT_FOUND: "No colony initialized. Run /ant:init first." and stop
@@ -776,7 +776,7 @@ body_opencode: |
 
   Run using the Bash tool with description "Loading compact planning context...":
   ```bash
-  bash .aether/aether-utils.sh context-capsule --compact --json 2>/dev/null
+  aether context-capsule --compact --json 2>/dev/null
   ```
 
   If JSON is valid and `.ok == true`, extract `.result.prompt_section` into `context_capsule_prompt`.
@@ -858,7 +858,7 @@ body_opencode: |
   **1. Retrieve hive wisdom for research priming:**
 
   ```bash
-  hive_context=$(bash .aether/aether-utils.sh hive-read --limit 5 --format text 2>/dev/null)
+  hive_context=$(aether hive-read --limit 5 --format text 2>/dev/null)
   ```
 
   Parse the JSON result to extract `.result.text` as `hive_text`. If command fails or returns empty, set `hive_text = ""`.
@@ -1260,7 +1260,7 @@ body_opencode: |
   if [[ "$verify_phases" -lt 1 || "$verify_timestamp" == "null" || "$verify_state" != "READY" ]]; then
     echo "ERROR: Plan write verification failed (phases=$verify_phases, generated_at=$verify_timestamp, state=$verify_state)"
     echo "Attempting retry write..."
-    bash .aether/aether-utils.sh state-write "$(jq --argjson phases "$(echo '$PLAN_JSON' | jq '.plan.phases')" --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '.plan.phases = $phases | .plan.generated_at = $ts | .state = "READY"' .aether/data/COLONY_STATE.json)"
+    aether state-write "$(jq --argjson phases "$(echo '$PLAN_JSON' | jq '.plan.phases')" --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '.plan.phases = $phases | .plan.generated_at = $ts | .state = "READY"' .aether/data/COLONY_STATE.json)"
     verify_phases=$(jq '.plan.phases | length' .aether/data/COLONY_STATE.json)
     if [[ "$verify_phases" -lt 1 ]]; then
       echo "FATAL: Retry write also failed. Plan was not persisted."
@@ -1271,7 +1271,7 @@ body_opencode: |
   echo "Plan verified: $verify_phases phases, generated_at=$verify_timestamp, state=$verify_state"
   ```
 
-  Log plan completion: `bash .aether/aether-utils.sh activity-log "PLAN_COMPLETE" "queen" "Plan finalized with {confidence}% confidence"`
+  Log plan completion: `aether activity-log "PLAN_COMPLETE" "queen" "Plan finalized with {confidence}% confidence"`
 
   Update watch-status.txt:
   ```

package/.aether/commands/quick.yaml

@@ -31,7 +31,7 @@ body: |
 
   {{TOOL_PREFIX "Naming scout..."}}
   ```bash
-  bash .aether/aether-utils.sh generate-ant-name "scout"
+  aether generate-ant-name --caste "scout"
   ```
 
   Capture the output as `scout_name`.
@@ -46,7 +46,7 @@ body: |
 
   {{TOOL_PREFIX "Dispatching scout..."}}
   ```bash
-  bash .aether/aether-utils.sh spawn-log "Queen" "scout" "{scout_name}" "Quick query: {query}"
+  aether spawn-log --name "Queen" --caste "scout" --id "{scout_name}" --description "Quick query: {query}"
   ```
 
   {{#claude}}
@@ -86,14 +86,14 @@ body: |
 
   {{TOOL_PREFIX "Recording scout completion..."}}
   ```bash
-  bash .aether/aether-utils.sh spawn-complete "{scout_name}" "completed" "Quick query answered"
+  aether spawn-complete --id "{scout_name}" --status "completed" --summary "Quick query answered"
   ```
 
   ### Step 5: Update Session (lightweight)
 
   {{TOOL_PREFIX "Updating session..."}}
   ```bash
-  bash .aether/aether-utils.sh session-update "/ant:quick" "" "Quick query: {query truncated to 60 chars}" 2>/dev/null || true
+  aether session-update --command "/ant:quick" --worker "" --summary "Quick query: {query truncated to 60 chars}" 2>/dev/null || true
   ```
 
   **NOTE:** This command does NOT:

package/.aether/commands/redirect.yaml

@@ -32,7 +32,7 @@ body: |
   {{#claude}}
   {{TOOL_PREFIX "Setting colony redirect..."}}
   ```bash
-  bash .aether/aether-utils.sh pheromone-write REDIRECT "<content>" --strength 0.9 --reason "User warned colony away from pattern" --ttl <ttl>
+  aether pheromone-write --type REDIRECT --content "<content>" --strength 0.9 --reason "User warned colony away from pattern" --ttl <ttl>
   ```
 
   Parse the returned JSON for the signal ID.
@@ -41,14 +41,14 @@ body: |
 
   {{TOOL_PREFIX "Updating context document..."}}
   ```bash
-  bash .aether/aether-utils.sh context-update constraint redirect "<content>" "user" 2>/dev/null || true
+  aether context-update --section constraint --key redirect --content "<content>" "user" 2>/dev/null || true
   ```
 
   ### Step 3: Get Active Counts
 
   {{TOOL_PREFIX "Counting active signals..."}}
   ```bash
-  bash .aether/aether-utils.sh pheromone-count
+  aether pheromone-count
   ```
 
   ### Step 4: Confirm
@@ -86,8 +86,8 @@ body: |
 
   **Write pheromone signal and update context:**
   ```bash
-  bash .aether/aether-utils.sh pheromone-write REDIRECT "$normalized_args" --strength 0.9 --reason "User warned colony away from pattern" 2>/dev/null || true
-  bash .aether/aether-utils.sh context-update constraint redirect "$normalized_args" "user" 2>/dev/null || true
+  aether pheromone-write --type REDIRECT --content "$normalized_args" --strength 0.9 --reason "User warned colony away from pattern" 2>/dev/null || true
+  aether context-update --section constraint --key redirect --content "$normalized_args" "user" 2>/dev/null || true
   ```
 
   ### Step 3: Confirm
@@ -118,6 +118,6 @@ body: |
   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
   ```
   {{/claude}}

package/.aether/commands/resume-colony.yaml

@@ -14,13 +14,13 @@ body_claude: |
   If `visual_mode` is true, run using the Bash tool with description "Initializing resume display...":
   ### Step 0.5: Version Check (Non-blocking)
 
-  Run using the Bash tool with description "Checking colony version...": `bash .aether/aether-utils.sh version-check-cached 2>/dev/null || true`
+  Run using the Bash tool with description "Checking colony version...": `aether version-check-cached 2>/dev/null || true`
 
   If the command succeeds and the JSON result contains a non-empty string, display it as a one-line notice. Proceed regardless of outcome.
 
   ### Step 1: Load State and Validate
 
-  Run using the Bash tool with description "Restoring colony session...": `bash .aether/aether-utils.sh load-state`
+  Run using the Bash tool with description "Restoring colony session...": `aether load-state`
 
   If successful:
   1. Parse state from result
@@ -35,7 +35,7 @@ body_claude: |
 
   Run using the Bash tool with description "Loading active pheromones...":
   ```bash
-  bash .aether/aether-utils.sh pheromone-read
+  aether pheromone-read
   ```
 
   Use `.result.signals` as the active signal list (already decay-filtered by runtime logic).
@@ -127,7 +127,7 @@ body_claude: |
 
   Use Bash tool with description "Cleaning up handoff file..." to remove HANDOFF.md: `rm -f .aether/HANDOFF.md`
 
-  Run using the Bash tool with description "Releasing colony lock...": `bash .aether/aether-utils.sh unload-state` to release lock.
+  Run using the Bash tool with description "Releasing colony lock...": `aether unload-state` to release lock.
 
   ### Step 7: Next Up
 
@@ -136,7 +136,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
   ```
 
   ---
@@ -204,13 +204,13 @@ body_opencode: |
 
   ### Step 0.5: Version Check (Non-blocking)
 
-  Run using the Bash tool: `bash .aether/aether-utils.sh version-check 2>/dev/null || true`
+  Run using the Bash tool: `aether version-check-cached 2>/dev/null || true`
 
   If the command succeeds and the JSON result contains a non-empty string, display it as a one-line notice. Proceed regardless of outcome.
 
   ### Step 1: Load State and Validate
 
-  Run using Bash tool: `bash .aether/aether-utils.sh load-state`
+  Run using Bash tool: `aether load-state`
 
   If successful:
   1. Parse state from result
@@ -225,7 +225,7 @@ body_opencode: |
 
   Run using the Bash tool:
   ```bash
-  bash .aether/aether-utils.sh pheromone-read
+  aether pheromone-read
   ```
 
   Use `.result.signals` as the active signal list (already decay-filtered by runtime logic).
@@ -317,7 +317,7 @@ body_opencode: |
 
   Use Bash tool to remove HANDOFF.md: `rm -f .aether/HANDOFF.md`
 
-  Run: `bash .aether/aether-utils.sh unload-state` to release lock.
+  Run: `aether unload-state` to release lock.
 
   ---
 

package/.aether/commands/resume.yaml

@@ -24,7 +24,7 @@ body: |
 
   {{TOOL_PREFIX "Restoring colony session..."}}:
   ```bash
-  bash .aether/aether-utils.sh session-read
+  aether session-read
   ```
 
   Parse the JSON result.
@@ -94,21 +94,9 @@ body: |
 
   ### Step 3: Read Pheromone Signals
 
-  {{#claude}}
-  Use the Read tool to read `.aether/data/constraints.json`.
-
-  Extract the following top-level keys:
-  - `focus` array — active focus signals (if key missing, treat as empty array)
-  - `constraints` array — active redirect/constraint signals (if key missing, treat as empty array)
-
-  If the file is missing: skip silently (no pheromones active).
-
-  Pheromones persist until explicitly cleared — no decay.
-  {{/claude}}
-  {{#opencode}}
   {{TOOL_PREFIX "Loading active pheromone signals..."}}:
   ```bash
-  bash .aether/aether-utils.sh pheromone-read all
+  aether pheromone-read all
   ```
 
   Parse the JSON result. Extract `.result.signals` array.
@@ -118,7 +106,6 @@ body: |
   - If the command fails or returns an error: skip silently (no pheromones active)
 
   Note: pheromone-read applies decay calculation automatically. The `effective_strength` field reflects current signal strength after time-based decay. Signals below 0.1 effective strength are already filtered out.
-  {{/opencode}}
 
   ---
 
@@ -301,19 +288,9 @@ body: |
 
   {if signals array from Step 3 is not empty:}
   Active Signals:
-  {{#claude}}
-  {for each focus signal:}
-    FOCUS: {focus text}
-  {end}
-  {for each constraint signal:}
-    REDIRECT: {constraint text}
-  {end}
-  {{/claude}}
-  {{#opencode}}
   {for each signal in signals:}
     {signal.type}: "{signal.content}" [{signal.effective_strength * 100 | floor}%]
   {end}
-  {{/opencode}}
   {end}
   ```
 
@@ -323,7 +300,7 @@ body: |
 
   {{TOOL_PREFIX "Loading memory health..."}}:
   ```bash
-  bash .aether/aether-utils.sh resume-dashboard
+  aether resume-dashboard
   ```
 
   Extract memory_health from the JSON result:
@@ -355,7 +332,7 @@ body: |
 
   {{TOOL_PREFIX "Marking session as resumed..."}}:
   ```bash
-  bash .aether/aether-utils.sh session-mark-resumed
+  aether session-mark-resumed
   ```
 
   ### Step 10: Next Up
@@ -365,7 +342,7 @@ body: |
   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
   ```
 
   ---
@@ -376,12 +353,7 @@ body: |
   |-----------|----------|
   | session.json missing (exists=false) | "No previous session found" — offer /ant:init and /ant:status |
   | COLONY_STATE.json missing or corrupted | Pause, ask user: start fresh or recover |
-  {{#claude}}
-  | constraints.json missing | Skip silently (no pheromones) |
-  {{/claude}}
-  {{#opencode}}
   | pheromone-read fails | Skip silently (no pheromones) |
-  {{/opencode}}
   | CONTEXT.md missing | Fall back to COLONY_STATE.json narrative |
   | No plan phases, no generated_at | BLOCK — redirect to /ant:plan |
   | Plan attempted but no phases | BLOCK — redirect to /ant:plan |
@@ -393,12 +365,7 @@ body: |
 
   ## Key Constraints
 
-  {{#claude}}
-  - Use Read tool for COLONY_STATE.json and constraints.json (not bash cat/jq).
-  {{/claude}}
-  {{#opencode}}
   - Use Read tool for COLONY_STATE.json (not bash cat/jq). Use Bash tool for pheromone-read (applies decay calculation).
-  {{/opencode}}
   - Use Bash tool only for aether-utils.sh commands and git commands
   - Handle ALL missing/corrupted file cases gracefully
   - Time-agnostic: restore identically regardless of how long ago the session was

package/.aether/commands/run.yaml

@@ -47,7 +47,7 @@ body: |
   (applying `--max-phases` cap), display the plan, then stop without executing.
 
   ```
-  ━━━ A U T O P I L O T   P R E V I E W ━━━
+  ━━━ 🤖 A U T O P I L O T   P R E V I E W ━━━
   Goal: {goal} | Current: Phase {N} | Remaining: {count} | Max: {max or "all"}
 
     Phase {id}: {name} ({task_count} tasks) -> build -> continue -> advance
@@ -66,9 +66,9 @@ body: |
      - If `milestone` == `"Crowned Anthill"`: output "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`." and stop
   2. Determine remaining incomplete phases; apply `--max-phases` cap
   3. Set `phases_completed = 0`, `autopilot_start = $(date +%s)`
-  4. Record pre-build blocker count: `bash .aether/aether-utils.sh flag-check-blockers {phase}`
+  4. Record pre-build blocker count: `aether flag-check-blockers {phase}`
   5. If `--headless` flag is present:
-     - Run: `bash .aether/aether-utils.sh autopilot-set-headless true`
+     - Run: `aether autopilot-set-headless true`
      - Display: `Headless mode: ON — interactive prompts will be queued as pending decisions`
   6. Display: `AUTOPILOT ENGAGED | Goal: {goal} | Phase {N} | Max: {max or "all"}`
 
@@ -105,7 +105,7 @@ body: |
   visual checkpoint prompt would normally be shown to the user, instead queue it as
   a pending decision:
   ```bash
-  bash .aether/aether-utils.sh pending-decision-add \
+  aether pending-decision-add \
     --title "Visual checkpoint: Phase {id}" \
     --type "checkpoint" \
     --description "{checkpoint_description}" \
@@ -134,7 +134,7 @@ body: |
   **Headless override for runtime verification:** If headless mode is active and
   runtime verification would normally pause, queue as a pending decision instead:
   ```bash
-  bash .aether/aether-utils.sh pending-decision-add \
+  aether pending-decision-add \
     --title "Runtime verification needed: Phase {id}" \
     --type "runtime-verification" \
     --description "Manual testing required before advancing past Phase {id}" \
@@ -165,7 +165,7 @@ body: |
   ### Step 5: Auto-Advance and Loop
 
   1. Increment `phases_completed`
-  2. Update autopilot state: `bash .aether/aether-utils.sh autopilot-update --action advance --phase {next} --result success`
+  2. Update autopilot state: `aether autopilot-update --action advance --phase {next} --result success`
   3. Log: `"<timestamp>|autopilot_advance|run|Phase {prev} -> {next} ({phases_completed}/{max})"`
   4. Display: `--- Autopilot: Phase {prev} done -> Phase {next} ({N}/{max}) ---`
   5. **Replan check** (see Step 5.5)
@@ -177,7 +177,7 @@ body: |
   After each successful phase advance, check if a replan pause should fire:
 
   ```bash
-  bash .aether/aether-utils.sh autopilot-check-replan --interval {replan_interval}
+  aether autopilot-check-replan --interval {replan_interval}
   ```
 
   If `--continue` flag was passed: skip this check entirely (user dismissed replan).
@@ -185,7 +185,7 @@ body: |
   If `result.should_replan == true`: **PAUSE** with replan suggestion banner:
 
   ```
-  ━━━ R E P L A N   S U G G E S T E D ━━━
+  ━━━ 🔄 R E P L A N   S U G G E S T E D ━━━
   Phases auto-completed: {N} | Learnings accumulated: {learnings_since_last}
 
   The colony has completed {N} phases since the last plan review.
@@ -203,7 +203,7 @@ body: |
   ### Step 6: Final Summary
 
   ```
-  ━━━ A U T O P I L O T   C O M P L E T E ━━━
+  ━━━ ✅ A U T O P I L O T   C O M P L E T E ━━━
   Phases completed: {N} | Elapsed: {Xm Ys} | Now at: Phase {current}
 
   {all complete}  -> Colony goal achieved! Run /ant:seal
@@ -218,7 +218,7 @@ body: |
   ```
 
   Update session:
-  `bash .aether/aether-utils.sh session-update "/ant:run" "/ant:run" "Autopilot: {N} phases, now Phase {current}"`
+  `aether session-update --command "/ant:run" --worker "/ant:run" --summary "Autopilot: {N} phases, now Phase {current}"`
 
   ## Execution Contract