aether-colony 3.1.17 → 5.1.0

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

@@ -1,3 +1,4 @@
+<!-- Generated from .aether/commands/pause-colony.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:pause-colony
 description: "💾🐜⏸️🐜💾 Pause colony work and create handoff document for resuming later"
@@ -13,16 +14,7 @@ Parse `$ARGUMENTS`:
 
 ### Step 0: Initialize Visual Mode (if enabled)
 
-If `visual_mode` is true:
-```bash
-# Generate session ID
-pause_id="pause-$(date +%s)"
-
-# Initialize swarm display
-bash .aether/aether-utils.sh swarm-display-init "$pause_id"
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "excavating" "Pausing colony" "Colony" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "fungus_garden" 0
-```
-
+If `visual_mode` is true, run using the Bash tool with description "Initializing pause display...":
 ### Step 1: Read State
 
 Use the Read tool to read `.aether/data/COLONY_STATE.json`.
@@ -31,13 +23,13 @@ If `goal` is null, output `No colony initialized. Nothing to pause.` and stop.
 
 ### Step 2: Compute Active Signals
 
-Read active signals from COLONY_STATE.json `signals` array (already loaded in Step 1).
-
-Filter signals where:
-- `expires_at` is null (permanent signals like INIT), OR
-- `expires_at` > current timestamp (not expired)
+Run using the Bash tool with description "Loading active pheromones...":
+```bash
+bash .aether/aether-utils.sh pheromone-read
+```
 
-If `signals` array is empty or all expired, treat as "no active pheromones."
+Use `.result.signals` as the active signal list (already decay-filtered by runtime logic).
+If empty, treat as "no active pheromones."
 
 ### Step 3: Build Handoff Summary
 
@@ -45,7 +37,7 @@ Gather context for the handoff from `COLONY_STATE.json`:
 - `goal` from top level
 - `state` and `current_phase` from top level
 - `workers` object
-- Active signals from `signals` array (with current decayed strengths from Step 2)
+- Active signals from `pheromone-read` output (with current decayed strengths from Step 2)
 - Phase progress from `plan.phases` (how many complete, current phase tasks)
 - What was in progress or pending
 
@@ -178,31 +170,25 @@ Continue to Step 5.
 
 ### Step 4.8: Update Context Document
 
-Log this pause activity to `.aether/CONTEXT.md`:
+Log this pause activity to `.aether/CONTEXT.md` by running using the Bash tool with description "Updating context document...":
 
 ```bash
 bash .aether/aether-utils.sh context-update activity "pause-colony" "Colony paused — handoff created" "—"
 ```
 
-Update safe-to-clear status:
+Update safe-to-clear status by running using the Bash tool with description "Marking safe to clear...":
 ```bash
 bash .aether/aether-utils.sh context-update safe-to-clear "YES" "Colony paused — safe to /clear, run /ant:resume-colony to continue"
 ```
 
 ### Step 5: Display Confirmation
 
-**If visual_mode is true, render final swarm display:**
-```bash
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "completed" "Colony paused" "Colony" '{"read":3,"grep":0,"edit":2,"bash":1}' 100 "fungus_garden" 100
-bash .aether/aether-utils.sh swarm-display-inline "$pause_id"
-```
-
 Output header:
 
 ```
-💾🐜⏸️🐜💾 ═══════════════════════════════════════════════════
+💾🐜⏸️🐜💾 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    C O L O N Y   P A U S E D
-═══════════════════════════════════════════════════ 💾🐜⏸️🐜💾
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 💾🐜⏸️🐜💾
 ```
 
 Then output:
@@ -235,3 +221,13 @@ If option 1 selected: proceed to run /ant:resume-colony flow
 If option 2 selected: run /ant:lay-eggs flow
 If option 3 selected: display "Run /ant:resume-colony when ready to continue, or /ant:lay-eggs to start fresh"
 ```
+
+### Step 6: Next Up
+
+Generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
+```bash
+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"
+```

package/.claude/commands/ant/phase.md

@@ -1,3 +1,4 @@
+<!-- Generated from .aether/commands/phase.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:phase
 description: "📝🐜📍🐜📝 Show phase details - Queen reviews phase status, tasks, and caste assignment"
@@ -34,11 +35,13 @@ Find the phase by ID in `plan.phases`.
 
 Output this header:
 
+
 ```
-📝🐜📍🐜📝 ═══════════════════════════════════════════════════
-   P H A S E   {id}   D E T A I L S
-═══════════════════════════════════════════════════ 📝🐜📍🐜📝
-```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📝🐜📍🐜📝  P H A S E   {id}   D E T A I L S
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+
 
 Then display:
 
@@ -55,63 +58,58 @@ Then display:
 ✅ Success Criteria:
    • <criterion>
 
-─────────────────────────────────────────────────────
-🐜 Next Steps:
+───────────────────────────────────────────────────
+
+🐜 Next Up
+
+
+───────────────────────────────────────────────────
    /ant:build <id>       🔨 Phase <id>: <phase_name>
    /ant:phase <next_id>  📋 Phase <next_id>: <next_phase_name> (only if not last phase)
    /ant:status           📊 Colony status
 ```
 
-Status icons: `[ ]` pending, `[~]` in_progress, `[✓]` completed
-
-### Step 3b: List View
 
-Output this header:
-
-```
-📝🐜📍🐜📝 ═══════════════════════════════════════════════════
-   A L L   P H A S E S
-═══════════════════════════════════════════════════ 📝🐜📍🐜📝
+After displaying phase details, generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
+```bash
+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"
 ```
 
-Then display all phases as a summary:
 
-```
-👑 Goal: "<goal>"
+Status icons: `[ ]` pending, `[~]` in_progress, `[✓]` completed
 
-   {icon} Phase <id>: <name>
-         <completed>/<total> tasks | <status>
+### Step 3b: List View
 
-(repeat for each phase)
+Output this header:
 
-─────────────────────────────────────────────────────
-Legend: [✓] completed  [~] in progress  [ ] pending
 
-🐜 /ant:phase <id> for details
 ```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📝🐜📍🐜📝  A L L   P H A S E S
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-### Step 4: Update Handoff (Optional)
 
-After displaying phase details, offer to update the handoff document with review notes:
 
-Use AskUserQuestion:
+For each phase in `plan.phases`, display:
 ```
-Update handoff with phase review notes?
-
-1. Yes — add notes about blockers or decisions
-2. No — continue without updating
+[{id}] {name} [{status}]
+   {short_description}
 ```
 
-If option 1 selected:
-Use AskUserQuestion to collect notes, then append to handoff:
-
-```bash
-cat >> .aether/HANDOFF.md << 'HANDOFF_EOF'
-
-## Phase {id} Review Notes
-- Reviewed: $(date -u +%Y-%m-%dT%H:%M:%SZ)
-- Notes: {user_notes}
-HANDOFF_EOF
+Display phases grouped by status:
+```
+✓ Completed
+   [{id}] {name}
+~ In Progress
+   [{id}] {name}
+[ ] Pending
+   [{id}] {name}
 ```
 
-Display: `Handoff updated with review notes.`
+Display completion progress:
+```
+📊 Overall: {completed_count}/{total_count} phases complete
+```

package/.claude/commands/ant/pheromones.md

@@ -0,0 +1,156 @@
+<!-- Generated from .aether/commands/pheromones.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:pheromones
+description: "🎯🐜🚫🐜💬 View and manage active pheromone signals"
+---
+
+You are the **Queen**. Display and manage the colony's pheromone signals.
+
+## Instructions
+
+Parse `$ARGUMENTS`:
+- If contains `--no-visual`: set `visual_mode = false` (visual is ON by default)
+- Otherwise: set `visual_mode = true`
+
+Extract subcommand from `$ARGUMENTS`:
+- No argument or `all`: Show all active pheromones
+- `focus`: Show only FOCUS signals
+- `redirect`: Show only REDIRECT signals
+- `feedback`: Show only FEEDBACK signals
+- `clear`: Clear expired/inactive signals
+- `expire <id>`: Expire a specific signal by ID
+
+### Step 1: Read Colony State
+
+Read `.aether/data/COLONY_STATE.json`.
+
+If file missing or `goal: null`:
+```
+No colony initialized. Run /ant:init first.
+```
+Stop here.
+
+### Step 2: Handle Subcommands
+
+**If subcommand is `clear`:**
+
+Run using the Bash tool:
+```bash
+# Count signals before
+before_count=$(jq '[.signals[] | select(.active == true)] | length' .aether/data/pheromones.json 2>/dev/null || echo "0")
+
+# Mark expired/inactive signals as inactive
+now=$(date +%s)
+jq --argjson now "$now" '
+  def to_epoch(ts):
+    if ts == null or ts == "" or ts == "phase_end" then null
+    else
+      (ts | split("T")) as $parts |
+      ($parts[0] | split("-")) as $d |
+      ($parts[1] | rtrimstr("Z") | split(":")) as $t |
+      (($d[0] | tonumber) - 1970) * 365 * 86400 +
+      (($d[1] | tonumber) - 1) * 30 * 86400 +
+      (($d[2] | tonumber) - 1) * 86400 +
+      ($t[0] | tonumber) * 3600 +
+      ($t[1] | tonumber) * 60 +
+      ($t[2] | rtrimstr("Z") | tonumber)
+    end;
+
+  def decay_days(t):
+    if t == "FOCUS"    then 30
+    elif t == "REDIRECT" then 60
+    else 90
+    end;
+
+  .signals = [.signals[] |
+    (to_epoch(.created_at)) as $created_epoch |
+    (if $created_epoch != null then ($now - $created_epoch) / 86400 else 0 end) as $elapsed_days |
+    (decay_days(.type)) as $dd |
+    ((.strength // 0.8) * (1 - ($elapsed_days / $dd))) as $eff_raw |
+    (if $eff_raw < 0 then 0 else $eff_raw end) as $eff |
+    if $eff < 0.1 then . + {active: false} else . end
+  ]
+' .aether/data/pheromones.json > .aether/data/pheromones.json.tmp && mv .aether/data/pheromones.json.tmp .aether/data/pheromones.json
+
+# Count signals after
+after_count=$(jq '[.signals[] | select(.active == true)] | length' .aether/data/pheromones.json 2>/dev/null || echo "0")
+cleared=$((before_count - after_count))
+
+echo "before=$before_count after=$after_count cleared=$cleared"
+```
+
+Display:
+```
+🧹 Pheromone Cleanup
+
+   Before: {before_count} active signals
+   After:  {after_count} active signals
+   Cleared: {cleared} expired signal(s)
+
+Run /ant:pheromones to see remaining signals.
+```
+Stop here.
+
+**If subcommand is `expire <id>`:**
+
+Extract the signal ID from arguments.
+Run using the Bash tool:
+```bash
+signal_id="{extracted_id}"
+jq --arg id "$signal_id" '.signals = [.signals[] | if .id == $id then . + {active: false} else . end]' .aether/data/pheromones.json > .aether/data/pheromones.json.tmp && mv .aether/data/pheromones.json.tmp .aether/data/pheromones.json && echo "expired=$signal_id"
+```
+
+Display:
+```
+✓ Signal expired: {signal_id}
+
+Run /ant:pheromones to see remaining signals.
+```
+Stop here.
+
+### Step 3: Display Active Pheromones (default or filter)
+
+Run using the Bash tool with description "Displaying pheromones...":
+```bash
+bash .aether/aether-utils.sh pheromone-display "{subcommand or 'all'}"
+```
+
+The output will be the formatted pheromone table.
+
+### Step 4: Summary and Next Steps
+
+Display guidance:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+💡 Managing Pheromones
+
+   /ant:focus "area"      🎯 Guide attention
+   /ant:redirect "avoid"  🚫 Set hard constraint
+   /ant:feedback "note"   💬 Provide guidance
+   /ant:pheromones clear  🧹 Clear expired signals
+
+🐜 Signals decay over time: FOCUS 30d, REDIRECT 60d, FEEDBACK 90d
+```
+
+### Edge Cases
+
+**No pheromones file:**
+```
+No pheromones active. Colony has no signals.
+
+Inject signals with:
+  /ant:focus "area"    - Guide attention
+  /ant:redirect "avoid" - Set hard constraint
+  /ant:feedback "note"  - Provide guidance
+```
+
+**No active signals of filtered type:**
+```
+No active {type} signals found.
+
+Try: /ant:pheromones (to see all)
+```
+
+**Invalid subcommand:**
+Display help showing valid subcommands.