aether-colony 5.0.0 → 5.2.1

package/.claude/commands/ant/preferences.md

@@ -0,0 +1,65 @@
+<!-- Generated from .aether/commands/preferences.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:preferences
+description: "Add or list user preferences in hub QUEEN.md"
+---
+
+You are the **Queen**. Manage user preferences in the hub `~/.aether/QUEEN.md`.
+
+## Instructions
+
+The input is: `$ARGUMENTS`
+
+### Step 1: Validate
+
+If `$ARGUMENTS` empty -> show usage: `/ant:preferences "preference text"` or `/ant:preferences --list`, stop.
+
+### Step 2: Route
+
+- `$ARGUMENTS` is `--list` -> **List mode**
+- Otherwise -> **Add mode**
+
+### List Mode
+
+Read `~/.aether/QUEEN.md`. If missing -> "No hub QUEEN.md found. Run /ant:init to create one.", stop.
+
+Find the `## User Preferences` section (with or without emoji). Extract bullet lines (`- ...`) between that heading and the next `---`.
+
+If user-added bullets exist, output each. Otherwise:
+```
+No user preferences set yet.
+Add one with: /ant:preferences "your preference"
+```
+Stop.
+
+### Add Mode
+
+Set `PREF` to `$ARGUMENTS` (strip surrounding quotes).
+If length > 500 chars -> "Preference too long (max 500 chars)", stop.
+
+Read `~/.aether/QUEEN.md`. If missing -> "No hub QUEEN.md found. Run /ant:init to create one.", stop.
+
+**If `## User Preferences` section exists** (with or without emoji):
+1. Remove `*No user preferences recorded yet.*` placeholder if present
+2. Append `- $PREF` at end of section (before next `---`)
+
+**If section missing** (migration case):
+1. Insert before `## Evolution Log` (with or without emoji):
+```
+## User Preferences
+
+- $PREF
+
+---
+
+```
+
+Update METADATA comment: increment `stats.total_user_prefs` by 1.
+
+### Confirm
+
+Output (2 lines, no banners):
+```
+Preference saved to hub QUEEN.md
+  "$PREF"
+```

package/.claude/commands/ant/quick.md

@@ -0,0 +1,100 @@
+<!-- Generated from .aether/commands/quick.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:quick
+description: "Quick scout query — fast answers without build ceremony"
+---
+
+You are the **Queen**. Execute `/ant:quick` — a lightweight scout mission.
+
+The query is: `$ARGUMENTS`
+
+## Purpose
+
+Quick, focused answers to questions about the codebase, patterns, or implementation
+details. No build ceremony, no state changes, no verification waves.
+
+## Instructions
+
+### Step 1: Validate Arguments
+
+If `$ARGUMENTS` is empty:
+```
+Usage: /ant:quick "<question>"
+
+Examples:
+  /ant:quick "how does the pheromone system work?"
+  /ant:quick "find all uses of acquire_lock"
+  /ant:quick "what tests cover midden-write?"
+  /ant:quick "show me the colony-prime token budget logic"
+```
+Stop here.
+
+### Step 2: Generate Scout Name
+
+Run using the Bash tool with description "Naming scout...":
+```bash
+bash .aether/aether-utils.sh generate-ant-name "scout"
+```
+
+Capture the output as `scout_name`.
+
+### Step 3: Spawn Scout
+
+Display:
+```
+━━━ Quick Scout ━━━
+Spawning {scout_name} — {query truncated to 50 chars}
+```
+
+Run using the Bash tool with description "Dispatching scout...":
+```bash
+bash .aether/aether-utils.sh spawn-log "Queen" "scout" "{scout_name}" "Quick query: {query}"
+```
+
+
+Spawn a Scout agent (using Task tool with subagent_type="aether-scout") with this prompt:
+
+```
+You are {scout_name}, a Scout Ant on a quick mission.
+
+Query: {query from ARGUMENTS}
+
+Work:
+1. Search the codebase to answer the query
+2. Use Grep, Glob, and Read tools to find relevant code
+3. Provide a clear, focused answer
+4. Include file paths and line numbers for key findings
+
+Keep your answer concise and actionable. This is a quick mission —
+don't explore exhaustively, focus on the most relevant answer.
+
+Return your findings as a clear text answer (not JSON).
+```
+
+
+
+### Step 4: Display Results
+
+
+Display the Scout's answer directly to the user.
+
+
+
+Run using the Bash tool with description "Recording scout completion...":
+```bash
+bash .aether/aether-utils.sh spawn-complete "{scout_name}" "completed" "Quick query answered"
+```
+
+### Step 5: Update Session (lightweight)
+
+Run using the Bash tool with description "Updating session...":
+```bash
+bash .aether/aether-utils.sh session-update "/ant:quick" "" "Quick query: {query truncated to 60 chars}" 2>/dev/null || true
+```
+
+**NOTE:** This command does NOT:
+- Modify COLONY_STATE.json
+- Advance phases
+- Create checkpoints
+- Spawn watchers or chaos ants
+- Run verification

package/.claude/commands/ant/redirect.md

@@ -1,10 +1,14 @@
+<!-- Generated from .aether/commands/redirect.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:redirect
 description: "Emit REDIRECT signal to warn colony away from patterns"
 ---
 
+
 You are the **Queen**. Emit a REDIRECT pheromone signal.
 
+
+
 ## Instructions
 
 The pattern to avoid is: `$ARGUMENTS`
@@ -14,15 +18,18 @@ The pattern to avoid is: `$ARGUMENTS`
 If `$ARGUMENTS` empty -> show usage: `/ant:redirect <pattern to avoid>`, stop.
 If content > 500 chars -> "Redirect content too long (max 500 chars)", stop.
 
+
 Parse optional flags from `$ARGUMENTS`:
 - `--ttl <value>`: signal lifetime (e.g., `2h`, `1d`, `7d`). Default: `phase_end`.
 - Strip flags from content before using it as the pattern.
 
+
 ### Step 2: Write Signal
 
 Read `.aether/data/COLONY_STATE.json`.
 If `goal: null` -> "No colony initialized.", stop.
 
+
 Run using the Bash tool with description "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>
@@ -30,6 +37,13 @@ bash .aether/aether-utils.sh pheromone-write REDIRECT "<content>" --strength 0.9
 
 Parse the returned JSON for the signal ID.
 
+### Step 2.5: Update Context Document
+
+Run using the Bash tool with description "Updating context document...":
+```bash
+bash .aether/aether-utils.sh context-update constraint redirect "<content>" "user" 2>/dev/null || true
+```
+
 ### Step 3: Get Active Counts
 
 Run using the Bash tool with description "Counting active signals...":
@@ -47,6 +61,9 @@ REDIRECT signal emitted
   Active signals: <focus_count> FOCUS, <redirect_count> REDIRECT, <feedback_count> FEEDBACK
 ```
 
+
+
+
 ### Step 5: Next Up
 
 Generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
@@ -56,3 +73,4 @@ 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/resume-colony.md

@@ -1,3 +1,4 @@
+<!-- Generated from .aether/commands/resume-colony.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:resume-colony
 description: "🚦➡️🐜💨💨 Resume colony from saved session - restores all state"
@@ -14,15 +15,6 @@ Parse `$ARGUMENTS`:
 ### Step 0: Initialize Visual Mode (if enabled)
 
 If `visual_mode` is true, run using the Bash tool with description "Initializing resume display...":
-```bash
-# Generate session ID
-resume_id="resume-$(date +%s)"
-
-# Initialize swarm display
-bash .aether/aether-utils.sh swarm-display-init "$resume_id"
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "excavating" "Resuming colony" "Colony" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "fungus_garden" 0
-```
-
 ### 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`
@@ -36,20 +28,43 @@ Run using the Bash tool with description "Restoring colony session...": `bash .a
 If successful:
 1. Parse state from result
 2. If goal is null: Show "No colony state found..." message and stop
-3. Check if paused flag is true - if not, note "Colony was not paused, but resuming anyway"
-4. Extract all state fields for display
+3. If `milestone` == `"Crowned Anthill"`: Show "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`." and stop
+4. Check if paused flag is true - if not, note "Colony was not paused, but resuming anyway"
+5. Extract all state fields for display
 
 Keep state loaded (don't unload yet) - we'll need it for the full display.
 
 ### Step 2: Compute Active Signals
 
-Read active signals from COLONY_STATE.json `signals` array (already loaded in Step 1).
+Run using the Bash tool with description "Loading active pheromones...":
+```bash
+bash .aether/aether-utils.sh pheromone-read
+```
+
+Use `.result.signals` as the active signal list (already decay-filtered by runtime logic).
+If empty, treat as "no active pheromones."
 
-Filter signals where:
-- `expires_at` is null (permanent signals like INIT), OR
-- `expires_at` > current timestamp (not expired)
+### Step 2.5: Load Survey Context (Advisory)
 
-If `signals` array is empty or all expired, treat as "no active pheromones."
+Run using the Bash tool with description "Loading survey context...":
+```bash
+survey_docs=$(ls -1 .aether/data/survey/*.md 2>/dev/null | wc -l | tr -d ' ')
+survey_latest=$(ls -t .aether/data/survey/*.md 2>/dev/null | head -1)
+if [[ -n "$survey_latest" ]]; then
+  now_epoch=$(date +%s)
+  modified_epoch=$(stat -f %m "$survey_latest" 2>/dev/null || stat -c %Y "$survey_latest" 2>/dev/null || echo 0)
+  survey_age_days=$(( (now_epoch - modified_epoch) / 86400 ))
+else
+  survey_age_days=-1
+fi
+echo "survey_docs=$survey_docs"
+echo "survey_age_days=$survey_age_days"
+```
+
+Interpretation:
+- `survey_docs == 0` => survey missing
+- `survey_age_days > 14` => survey stale
+- otherwise survey fresh
 
 ### Step 3: Display Restored State
 
@@ -87,18 +102,18 @@ PHASE PROGRESS
   Phase <id>: <name> [<status>]
   (list all phases from plan.phases)
 
+SURVEY CONTEXT
+  Docs: <survey_docs>
+  Age: <survey_age_days> days
+  Status: <fresh|stale|missing>
+  Recommendation: <if missing or stale, suggest /ant:colonize --force-resurvey>
+
 CONTEXT FROM HANDOFF
   <summarize what was happening from .aether/HANDOFF.md>
 
 NEXT ACTIONS
 ```
 
-**If visual_mode is true, render final swarm display** by running using the Bash tool with description "Updating resume display...":
-```bash
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "completed" "Colony resumed" "Colony" '{"read":3,"grep":0,"edit":2,"bash":1}' 100 "fungus_garden" 100
-bash .aether/aether-utils.sh swarm-display-text "$resume_id"
-```
-
 Route to next action based on state:
 - If state is `READY` and there's a pending phase -> suggest `/ant:build <phase>`
 - If state is `EXECUTING` -> note that a build was interrupted, suggest restarting with `/ant:build <phase>`

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

@@ -1,7 +1,7 @@
+<!-- Generated from .aether/commands/resume.yaml - DO NOT EDIT DIRECTLY -->
 ---
-name: resume
+name: ant:resume
 description: "Resume Previous Session"
-symbol: refresh
 ---
 
 # /ant:resume — Resume Previous Session
@@ -24,7 +24,7 @@ Execute the following steps in order when the user runs `/ant:resume`.
 
 ### Step 1: Read Session State
 
-Run using the Bash tool with description "Restoring colony session...":
+Run using the Bash tool with description "Restoring colony session..."::
 ```bash
 bash .aether/aether-utils.sh session-read
 ```
@@ -35,6 +35,7 @@ Parse the JSON result.
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
 RESUME SESSION
 
 No previous session found.
@@ -42,6 +43,7 @@ No previous session found.
 Start fresh: /ant:init "your goal"
 Or check: /ant:status
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
 ```
 
 - If `exists` is `true`: extract from the session data:
@@ -60,6 +62,7 @@ Use the Read tool to read `.aether/data/COLONY_STATE.json`.
 
 COLONY_STATE.json is the authoritative source for goal and state (session.json may be stale). Extract:
 - `goal` (use this as authoritative, overriding session.json colony_goal)
+- `milestone` (check for sealed colony)
 - `state` (READY, PLANNING, EXECUTING, PAUSED)
 - `current_phase`
 - `plan.phases` (array with id, name, status for each phase)
@@ -67,6 +70,14 @@ COLONY_STATE.json is the authoritative source for goal and state (session.json m
 - `memory.decisions` (flat list — do NOT distinguish user vs Claude origin)
 - `events` (last 5 for recent activity context)
 
+**If `milestone` == `"Crowned Anthill"`:** This colony has been sealed. Display:
+```
+This colony has been sealed (Crowned Anthill).
+
+Start a new colony with /ant:init "new goal"
+```
+Stop here — do NOT display stale phase data from the sealed colony.
+
 If the file is missing or the JSON cannot be parsed, **stop immediately** and display:
 
 ```
@@ -85,6 +96,7 @@ Do NOT proceed with stale or fabricated data.
 
 ### Step 3: Read Pheromone Signals
 
+
 Use the Read tool to read `.aether/data/constraints.json`.
 
 Extract the following top-level keys:
@@ -95,6 +107,8 @@ If the file is missing: skip silently (no pheromones active).
 
 Pheromones persist until explicitly cleared — no decay.
 
+
+
 ---
 
 ### Step 4: Read CONTEXT.md
@@ -238,6 +252,7 @@ Lead with the next-step recommendation. Context follows underneath ("straight to
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
 RESUME SESSION
 
 Next: {recommended}
@@ -273,15 +288,47 @@ Recent Decisions:
 {end}
 {end}
 
-{if focus array or constraints array is not empty:}
+{if signals array from Step 3 is not empty:}
 Active Signals:
+
 {for each focus signal:}
   FOCUS: {focus text}
 {end}
 {for each constraint signal:}
   REDIRECT: {constraint text}
 {end}
+
+
 {end}
+```
+
+---
+
+### Step 8.5: Display Memory Health (Secondary)
+
+Run using the Bash tool with description "Loading memory health..."::
+```bash
+bash .aether/aether-utils.sh resume-dashboard
+```
+
+Extract memory_health from the JSON result:
+- wisdom_count
+- pending_promotions
+- recent_failures
+
+Display after the main dashboard:
+```
+📊 Memory Health
+   Wisdom: {wisdom_count} entries | Pending: {pending_promotions} promotions | Failures: {recent_failures} recent
+
+   Run /ant:memory-details for full breakdown
+```
+
+If all counts are 0, show:
+```
+📊 Memory Health
+   No accumulated wisdom yet. Complete phases to build colony memory.
+```
 
 Last Command: {last_command}
 Session: {session_id}
@@ -291,14 +338,14 @@ Session: {session_id}
 
 ### Step 9: Mark Session Resumed
 
-Run using the Bash tool with description "Marking session as resumed...":
+Run using the Bash tool with description "Marking session as resumed..."::
 ```bash
 bash .aether/aether-utils.sh session-mark-resumed
 ```
 
 ### Step 10: Next Up
 
-Generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
+Generate the state-based Next Up block by Run 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)
@@ -314,7 +361,10 @@ bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_pha
 |-----------|----------|
 | 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 |
+
 | constraints.json missing | Skip silently (no pheromones) |
+
+
 | 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 |
@@ -326,7 +376,10 @@ bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_pha
 
 ## Key Constraints
 
-- Use Read tool for COLONY_STATE.json and constraints.json (not bash cat/jq)
+
+- Use Read tool for COLONY_STATE.json and constraints.json (not bash cat/jq).
+
+
 - 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