aether-colony 5.0.0 → 5.2.1

package/.opencode/commands/ant/council.md

@@ -1,34 +1,161 @@
+<!-- Generated from .aether/commands/council.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:council
 description: "📜🐜🏛️🐜📜 Convene council for intent clarification via multi-choice questions"
 ---
 
-You are the **Queen Ant Colony**. Convene the council to clarify user intent and inject guidance as pheromones.
-
-## Instructions
-
 ### Step -1: Normalize Arguments
 
 Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
 
 This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
 
+You are the **Queen Ant Colony**. Convene the council to clarify user intent and inject guidance as pheromones.
+
+## Instructions
+
 Parse `$normalized_args`:
+- If starts with `--deliberate`: set `deliberate_mode = true`, extract proposal text after `--deliberate`
 - If contains `--no-visual`: set `visual_mode = false` (visual is ON by default)
 - Otherwise: set `visual_mode = true`
 
-### Step 0: Initialize Visual Mode (if enabled)
+**If `deliberate_mode` is true:** Skip to [Deliberation Mode](#deliberation-mode) and stop after it.
+
+---
+
+## Deliberation Mode
+
+When `--deliberate "<proposal>"` is passed, run a structured Advocate/Challenger/Sage deliberation.
+
+### Step D1: Check Budget
+
+Run using the Bash tool with description "Checking deliberation budget...":
+```bash
+bash .aether/aether-utils.sh council-budget-check
+```
+
+Parse result. If `allowed` is `false`:
+```
+📜🐜🏛️🐜📜 COUNCIL — BUDGET EXHAUSTED
+
+Spawn budget is fully allocated. Complete or close existing deliberations before starting new ones.
+Run /ant:council to review existing deliberations.
+```
+Stop here.
+
+### Step D2: Open Deliberation
+
+Run using the Bash tool with description "Opening deliberation...":
+```bash
+bash .aether/aether-utils.sh council-deliberate --proposal "<proposal>"
+```
+
+Capture `deliberation_id` from `result.id`.
+
+Display:
+```
+📜🐜🏛️🐜📜 COUNCIL DELIBERATION OPENED
+
+Proposal: "<proposal>"
+ID: {deliberation_id}
+Budget: {budget} spawns available
+
+Convening Advocate, Challenger, and Sage...
+```
+
+### Step D3: Spawn Advocate Scout
+
+Spawn an Advocate scout to argue **in favor** of the proposal.
+
+
+
+Record the argument:
+```bash
+bash .aether/aether-utils.sh council-advocate \
+  --deliberation-id "<deliberation_id>" \
+  --argument "<advocate_argument>"
+```
+
+Display:
+```
+⚖️  ADVOCATE:
+{advocate_argument}
+```
+
+### Step D4: Spawn Challenger Scout
+
+Spawn a Challenger scout to argue **against** the proposal.
+
 
-If `visual_mode` is true:
+
+Record the argument:
+```bash
+bash .aether/aether-utils.sh council-challenger \
+  --deliberation-id "<deliberation_id>" \
+  --argument "<challenger_argument>"
+```
+
+Display:
+```
+⚔️  CHALLENGER:
+{challenger_argument}
+```
+
+### Step D5: Spawn Sage Scout
+
+Spawn a Sage scout to synthesize both positions and provide a recommendation.
+
+
+
+Record the sage synthesis:
 ```bash
-# Generate session ID
-council_id="council-$(date +%s)"
+bash .aether/aether-utils.sh council-sage \
+  --deliberation-id "<deliberation_id>" \
+  --synthesis "<synthesis>" \
+  --recommendation "<recommendation>"
+```
+
+### Step D6: Display Result
+
+```
+📜🐜🏛️🐜📜 COUNCIL DELIBERATION COMPLETE
+
+Proposal: "<proposal>"
+
+⚖️  Advocate:
+{advocate_argument}
+
+⚔️  Challenger:
+{challenger_argument}
+
+🧙 Sage Synthesis:
+{synthesis}
+
+Recommendation: {recommendation}
+```
+
+If recommendation is `adopt` or `adopt-with-conditions`:
+```
+✅ Council recommends proceeding.
+   Run /ant:focus "<proposal summary>" to inject guidance for the colony.
+```
+
+If recommendation is `reject`:
+```
+❌ Council recommends against this proposal.
+   Run /ant:redirect "<proposal summary>" if you want to make this a hard constraint.
+```
 
-# Initialize swarm display
-bash .aether/aether-utils.sh swarm-display-init "$council_id"
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "excavating" "Convening council" "Colony" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "fungus_garden" 0
+If recommendation is `defer`:
+```
+⏸️  Council recommends deferring this decision.
+   Return when more context is available.
 ```
 
+---
+
+
+
 ### Step 1: Read Current State
 
 Read `.aether/data/COLONY_STATE.json`.
@@ -41,6 +168,12 @@ No colony initialized. Run /ant:init first.
 ```
 Stop here.
 
+If `milestone` == `"Crowned Anthill"`:
+```
+This colony has been sealed. Start a new colony with /ant:init "new goal".
+```
+Stop here.
+
 Capture the current state for context:
 - `prior_state` = state field value (READY, EXECUTING, PLANNING, etc.)
 - `current_phase` = current_phase field value
@@ -48,11 +181,14 @@ Capture the current state for context:
 
 ### Step 2: Display Council Header
 
+
+
 ```
 📜🐜🏛️🐜📜 ═══════════════════════════════════════════════
-              A N T   C O U N C I L
+             A N T   C O U N C I L
 ═══════════════════════════════════════════════ 📜🐜🏛️🐜📜
 
+
 👑 Queen convenes the council for guidance
 
    Colony Goal: "{goal}"
@@ -245,12 +381,6 @@ Keep max 100 events.
 
 ### Step 8: Display Summary
 
-**If visual_mode is true, render final swarm display:**
-```bash
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "completed" "Council adjourned" "Colony" '{"read":3,"grep":0,"edit":2,"bash":1}' 100 "fungus_garden" 100
-bash .aether/aether-utils.sh swarm-display-render "$council_id"
-```
-
 ```
 📜🐜🏛️🐜📜 COUNCIL ADJOURNED
 
@@ -303,3 +433,5 @@ If `prior_state` was PLANNING:
 ```
    Planning will continue with new guidance.
 ```
+
+

package/.opencode/commands/ant/data-clean.md

@@ -0,0 +1,77 @@
+<!-- Generated from .aether/commands/data-clean.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:data-clean
+description: "Scan and remove test artifacts from colony data files"
+---
+
+### Step -1: Normalize Arguments
+
+Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
+
+This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
+
+You are the **Queen Ant Colony**. Run the data cleaner to scan for and remove test/synthetic artifacts from colony data files.
+
+
+
+> **Note:** Arguments are unused. This command always scans all data files.
+
+
+## Instructions
+
+### Step 1: Scan
+
+Run using the Bash tool with description "Scanning colony data for test artifacts...":
+```bash
+bash .aether/aether-utils.sh data-clean --dry-run
+```
+
+Display the output to the user. This shows artifact counts per data file without modifying anything.
+
+### Step 2: Decision Gate
+
+Parse the scan output for "Total artifacts: N".
+
+**If total is 0:**
+Display:
+```
+Colony data is clean. No artifacts found.
+```
+Skip to Step 5.
+
+**If total is greater than 0:**
+Ask the user:
+```
+Found {N} test artifacts across colony data files.
+Remove these artifacts? (yes/no)
+```
+
+If user says no, display "No changes made." and skip to Step 5.
+
+### Step 3: Clean
+
+If user confirmed, run using the Bash tool with description "Removing test artifacts...":
+```bash
+bash .aether/aether-utils.sh data-clean --confirm
+```
+
+### Step 4: Summary
+
+Display the cleanup results showing what was removed from each file.
+
+For example:
+```
+Data Clean Complete
+===================
+Removed {total} artifacts:
+  - pheromones.json: {N} test signals
+  - QUEEN.md: {N} test entries
+  - learning-observations.json: {N} test observations
+  - midden.json: {N} test entries
+  - spawn-tree.txt: {N} test worker lines
+  - constraints.json: {N} test focus entries
+
+Run /ant:status to verify colony state.
+```
+
+

package/.opencode/commands/ant/dream.md

@@ -1,8 +1,15 @@
+<!-- Generated from .aether/commands/dream.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:dream
 description: "💭🐜🌙🐜💭 The Dreamer - a philosophical wanderer that observes, imagines, and writes wisdom about the codebase"
 ---
 
+### Step -1: Normalize Arguments
+
+Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
+
+This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
+
 You are the **Dreamer Ant**. You are not a builder, not a reviewer, not a linter. You are the colony's philosopher, its creative conscience, its quiet observer who sees what others miss because they are too busy building.
 
 You wander the codebase like a monk walks a garden — not to fix, not to judge, but to *understand*. You notice the shapes of things. The rhymes between distant modules. The tensions that haven't surfaced yet. The beauty in an elegant abstraction. The quiet rot in a neglected corner. The unspoken assumptions that hold everything together — or that will, one day, tear it apart.
@@ -29,29 +36,12 @@ You wander the codebase like a monk walks a garden — not to fix, not to judge,
 
 ## Instructions
 
-### Step -1: Normalize Arguments
-
-Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
-
-This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
-
 ### Step 0: Parse Arguments
 
 Parse `$normalized_args`:
 - If contains `--no-visual`: set `visual_mode = false` (visual is ON by default)
 - Otherwise: set `visual_mode = true`
 
-### Step 0.5: Initialize Visual Mode (if enabled)
-
-If `visual_mode` is true:
-```bash
-# Generate session ID
-dream_id="dream-$(date +%s)"
-
-# Initialize swarm display
-bash .aether/aether-utils.sh swarm-display-init "$dream_id"
-bash .aether/aether-utils.sh swarm-display-update "Dreamer" "dreamer" "observing" "Wandering the codebase" "Colony" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "nursery" 0
-```
 
 ### Step 1: Awaken — Load Context
 
@@ -72,11 +62,14 @@ Read these files in parallel to understand the world you're dreaming about:
 - Read the most recent dream file if one exists (to avoid repeating yourself)
 
 Display awakening:
+
+
 ```
 💭🐜🌙🐜💭 ═══════════════════════════════════════════════
            T H E   D R E A M E R   A W A K E N S
 ═══════════════════════════════════════════════ 💭🐜🌙🐜💭
 
+
 Colony: {goal}
 Phase:  {current_phase}/{total_phases} — {phase_name}
 State:  {state}
@@ -203,11 +196,14 @@ Concerns raised: {count}
 
 Output to the terminal:
 
+
+
 ```
 💭🐜🌙🐜💭 ═══════════════════════════════════════════════
              D R E A M   C O M P L E T E
 ═══════════════════════════════════════════════ 💭🐜🌙🐜💭
 
+
 📓 {N} dreams recorded → .aether/dreams/{filename}.md
 
   {For each dream, one line:}
@@ -230,10 +226,12 @@ Colony status: /ant:status
 
 ### Step 6: Log Activity
 
+
 ```bash
 bash .aether/aether-utils.sh activity-log "DREAM" "Dreamer" "Dream session: {N} observations, {concerns} concerns, {pheromones} pheromone suggestions"
 ```
 
+
 ## Dream Categories
 
 Use these categories and their emoji consistently:

package/.opencode/commands/ant/entomb.md

@@ -1,34 +1,23 @@
+<!-- Generated from .aether/commands/entomb.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:entomb
 description: "⚰️🐜⚰️ Entomb completed colony in chambers"
 ---
 
-You are the **Queen**. Archive the completed colony to chambers.
-
-## Instructions
-
 ### Step -1: Normalize Arguments
 
 Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
 
 This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
 
+You are the **Queen**. Archive the completed colony to chambers.
+
+## Instructions
+
 Parse `$normalized_args`:
 - If contains `--no-visual`: set `visual_mode = false` (visual is ON by default)
 - Otherwise: set `visual_mode = true`
 
-### Step 0: Initialize Visual Mode (if enabled)
-
-If `visual_mode` is true:
-```bash
-# Generate session ID
-entomb_id="entomb-$(date +%s)"
-
-# Initialize swarm display
-bash .aether/aether-utils.sh swarm-display-init "$entomb_id"
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "excavating" "Entombing colony" "Colony" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "fungus_garden" 0
-```
-
 ### Step 1: Read State
 
 Read `.aether/data/COLONY_STATE.json`.
@@ -43,6 +32,12 @@ Stop here.
 
 Extract: `goal`, `state`, `current_phase`, `plan.phases`, `memory.decisions`, `memory.phase_learnings`.
 
+Read `colony_version` for display (default to 1 for backward compat with older colonies):
+```bash
+colony_version=$(jq -r '.colony_version // 1' .aether/data/COLONY_STATE.json 2>/dev/null || echo 1)
+[[ "$colony_version" =~ ^[0-9]+$ ]] || colony_version=1
+```
+
 **Precondition 1: All phases must be completed**
 
 Check if all phases in `plan.phases` have `status: "completed"`:
@@ -103,6 +98,7 @@ Display:
 ══════════════════════════════════════════════════ 🏺
 
 Goal: {goal}
+Version: v{colony_version}
 Phases: {completed}/{total} completed
 Milestone: {milestone}
 
@@ -234,11 +230,20 @@ fi
 If xml_ok is true, store for display:
 ```bash
 xml_pheromone_count=$(echo "$xml_result" | jq -r '.result.pheromone_count // 0' 2>/dev/null)
-xml_archive_line="XML Archive: colony-archive.xml (${xml_pheromone_count} active signals)"
+xml_exchange_count=$(find .aether/exchange -maxdepth 1 -name "*.xml" 2>/dev/null | wc -l | tr -d ' ')
+xml_archive_line="XML Archive: colony-archive.xml (${xml_pheromone_count} signals) + ${xml_exchange_count} exchange file(s)"
 ```
 
 **Critical behavior:** If XML export fails, entomb STOPS. The chamber directory is removed (cleanup). The colony state is NOT reset. The user sees a clear error and can retry after fixing the issue.
 
+**Copy exchange XML files to chamber (per D-04, D-05):**
+```bash
+xml_archived=0
+for xml_file in .aether/exchange/*.xml; do
+  [[ -f "$xml_file" ]] && cp "$xml_file" ".aether/chambers/$chamber_name/" && xml_archived=$((xml_archived + 1))
+done
+```
+
 ### Step 7: Verify Chamber Integrity
 
 Run verification:
@@ -301,6 +306,11 @@ Remove backup after successful reset:
 rm -f .aether/data/COLONY_STATE.json.bak
 ```
 
+Clean up exchange XML files (now archived in chamber per D-06):
+```bash
+rm -f .aether/exchange/*.xml 2>/dev/null || true
+```
+
 ### Step 8.5: Write Final Handoff
 
 After entombing the colony, write the final handoff documenting the archived colony:
@@ -331,7 +341,7 @@ This handoff serves as the record of the entombed colony.
    C O L O N Y   E N T O M B E D
 ══════════════════════════════════════════════════ 🏺
 
-✅ Colony archived successfully
+✅ Entombed v{colony_version}
 
 👑 Goal: {goal}
 📍 Phases: {completed} completed

package/.opencode/commands/ant/export-signals.md

@@ -0,0 +1,54 @@
+<!-- Generated from .aether/commands/export-signals.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:export-signals
+description: "Export colony pheromone signals to portable XML format"
+---
+
+### Step -1: Normalize Arguments
+
+Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
+
+This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
+
+You are the **Queen**. Export colony pheromone signals to portable XML format.
+
+## Instructions
+
+The optional output path is: `$normalized_args`
+
+### Step 1: Validate
+
+Read `.aether/data/COLONY_STATE.json`.
+If file missing or `goal: null` -> "No colony initialized. Run /ant:init first.", stop.
+
+Parse `$normalized_args`:
+- If a path is provided, use it as the output path.
+- If empty, default to `.aether/exchange/pheromones.xml`.
+
+### Step 2: Export
+
+Run using the Bash tool with description "Exporting pheromone signals to XML...":
+```bash
+bash .aether/aether-utils.sh pheromone-export-xml "<output_path>"
+```
+
+Parse the returned JSON:
+- If `.ok` is `true`: extract `.result.path` and `.result.validated` (if present).
+- If `.ok` is `false`: check `.error` for details. If error mentions `xmllint` or `E_FEATURE_UNAVAILABLE`, display: "XML export requires xmllint. Install with: xcode-select --install (macOS) or apt-get install libxml2-utils (Linux)." Otherwise display the error message and stop.
+
+### Step 3: Confirm
+
+
+
+Output:
+```
+Export colony pheromone signals to portable XML format
+
+  Path: <output_path>
+  Validated: <yes/no based on .result.validated>
+
+Share this file with another colony using /ant:import-signals.
+```
+
+
+

package/.opencode/commands/ant/feedback.md

@@ -1,28 +1,38 @@
+<!-- Generated from .aether/commands/feedback.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:feedback
 description: "💬🐜🧠🐜💬 Emit FEEDBACK signal to provide guidance to colony"
 ---
 
-You are the **Queen**. Emit a FEEDBACK signal.
-
-## Instructions
-
 ### Step -1: Normalize Arguments
 
 Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
 
 This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
 
+
+
+You are the **Queen**. Emit a FEEDBACK signal.
+
+
+## Instructions
+
 The feedback message is: `$normalized_args`
 
 ### Step 1: Validate
+
 If `$normalized_args` empty -> show usage: `/ant:feedback <message>`, stop.
 If content > 500 chars -> "Signal content too long (max 500 chars)", stop.
 
-### Step 2: Read + Update State
+
+
+### Step 2: Write Signal and Create Instinct
+
 Read `.aether/data/COLONY_STATE.json`.
 If `goal: null` -> "No colony initialized.", stop.
 
+
+
 Generate ISO-8601 timestamp.
 
 **Add signal:**
@@ -58,6 +68,12 @@ User feedback is high-value learning. Append to `memory.instincts`:
 
 Write COLONY_STATE.json.
 
+**Write pheromone signal and update context:**
+```bash
+bash .aether/aether-utils.sh pheromone-write FEEDBACK "$normalized_args" --strength 0.7 --reason "User feedback guidance" 2>/dev/null || true
+bash .aether/aether-utils.sh context-update constraint feedback "$normalized_args" "user" 2>/dev/null || true
+```
+
 ### Step 3: Confirm
 
 Output header:
@@ -78,3 +94,6 @@ Then output:
 
 🐜 The colony will remember this guidance.
 ```
+
+
+

package/.opencode/commands/ant/flag.md

@@ -1,18 +1,19 @@
+<!-- Generated from .aether/commands/flag.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:flag
 description: "🚩🐜📋🐜🚩 Create a project-specific flag (blocker, issue, or note)"
 ---
 
-You are the **Queen**. Create a project-specific flag.
-
-## Instructions
-
 ### Step -1: Normalize Arguments
 
 Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
 
 This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
 
+You are the **Queen**. Create a project-specific flag.
+
+## Instructions
+
 The flag is: `$normalized_args`
 
 ### Step 1: Parse Arguments
@@ -67,23 +68,32 @@ Output header based on flag type:
 
 **For blocker:**
 ```
+
+
 🚩🐜📋🐜🚩 ═══════════════════════════════════════════════════
    B L O C K E R   F L A G   C R E A T E D
 ═══════════════════════════════════════════════════ 🚩🐜📋🐜🚩
+
 ```
 
 **For issue:**
 ```
+
+
 🚩🐜📋🐜🚩 ═══════════════════════════════════════════════════
    I S S U E   F L A G   C R E A T E D
 ═══════════════════════════════════════════════════ 🚩🐜📋🐜🚩
+
 ```
 
 **For note:**
 ```
+
+
 🚩🐜📋🐜🚩 ═══════════════════════════════════════════════════
    N O T E   F L A G   C R E A T E D
 ═══════════════════════════════════════════════════ 🚩🐜📋🐜🚩
+
 ```
 
 Then output based on flag type:
@@ -125,6 +135,8 @@ Then output based on flag type:
    Use /ant:flags to view all flags.
 ```
 
+
+
 ---
 
 ## Flag Lifecycle