aether-colony 5.0.0 → 5.1.0

package/.opencode/commands/ant/help.md

@@ -1,8 +1,15 @@
+<!-- Generated from .aether/commands/help.yaml - DO NOT EDIT DIRECTLY -->
 ---
-name: help
-description: "🐜📖 Aether Colony - command reference and system overview"
+name: ant:help
+description: "Aether Colony - command reference and system overview"
 ---
 
+### 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**. Display the system overview and available commands.
 
 ## Instructions
@@ -11,14 +18,16 @@ Output the following:
 
 ```
 👑 AETHER QUEEN ANT COLONY
+
 ══════════════════════════════════════════
 
   A multi-agent system built on ant colony intelligence.
   Workers self-organize via pheromone signals. You guide with intention.
 
-GETTING STARTED
+SETUP & GETTING STARTED
 
-  /ant:init "<goal>"     Set colony intention and initialize
+  /ant:lay-eggs          Set up Aether in this repo (one-time, creates .aether/)
+  /ant:init "<goal>"     Start a colony with a goal
   /ant:colonize          Analyze existing codebase (optional)
   /ant:plan              Generate project plan
   /ant:build <phase>     Execute a phase (spawns parallel workers)
@@ -29,24 +38,31 @@ PHEROMONE COMMANDS
   /ant:focus "<area>"    Guide colony attention (priority: normal, expires: phase end)
   /ant:redirect "<pat>"  Warn away from pattern (priority: high, expires: phase end)
   /ant:feedback "<msg>"  Adjust behavior (priority: low, expires: phase end)
+  /ant:pheromones        View and manage active pheromone signals
+  /ant:export-signals [path]  Export pheromone signals to portable XML
+  /ant:import-signals <file> [colony]  Import signals from another colony's XML
 
 STATUS & UPDATES
 
   /ant:status            Colony dashboard — goal, phase, instincts, flags
   /ant:update            Update system files from global hub (~/.aether/)
   /ant:phase [N|list]    View phase details or list all phases
+  /ant:insert-phase      Insert a corrective phase after current phase
   /ant:flags             List active flags (blockers, issues, notes)
   /ant:flag "<title>"    Create a flag (blocker, issue, or note)
 
+
 SESSION COMMANDS
 
   /ant:pause-colony      Save state and create handoff document
   /ant:resume-colony     Restore from pause (full state + context)
+
   /ant:watch             Set up tmux session for live colony visibility
 
 COLONY LIFECYCLE
 
   /ant:seal             Seal colony with Crowned Anthill milestone
+  /ant:entomb           Archive completed colony into chambers
   /ant:history          Browse colony event history
 
 ADVANCED
@@ -58,10 +74,15 @@ ADVANCED
   /ant:interpret         Review dreams — validate against codebase, discuss action
   /ant:chaos             🎲 Resilience testing — adversarial probing of the codebase
   /ant:archaeology       🏺 Git history analysis — excavate patterns from commit history
+  /ant:tunnels           Browse archived colonies and compare chambers
 
 TYPICAL WORKFLOW
 
-  1. /ant:init "Build a REST API with auth"
+  First time in a repo:
+  0. /ant:lay-eggs                           (set up Aether in this repo)
+
+  Starting a colony:
+  1. /ant:init "Build a REST API with auth"  (start colony with a goal)
   2. /ant:colonize                           (if existing code)
   3. /ant:plan                               (generates phases)
   4. /ant:focus "security"                   (optional guidance)
@@ -73,6 +94,11 @@ TYPICAL WORKFLOW
   8. /ant:resume-colony                      (restore full context)
   9. /ant:status                             (see where you left off)
 
+  After completing a colony:
+  10. /ant:seal                              (mark as complete)
+  11. /ant:entomb                            (archive to chambers)
+  12. /ant:init "next project goal"          (start fresh colony)
+
 WORKER CASTES
 
   👑 Queen        — orchestrates, spawns workers, synthesizes results
@@ -88,7 +114,10 @@ WORKER CASTES
 HOW IT WORKS
 
   Colony Lifecycle:
-    INIT → PLAN → BUILD → CONTINUE → BUILD → ... → COMPLETE
+
+
+    LAY-EGGS → INIT → PLAN → BUILD → CONTINUE → BUILD → ... → SEAL → ENTOMB
+
 
   Workers spawn sub-workers autonomously (max depth 3).
   Builders receive colony knowledge (instincts, learnings, error patterns).
@@ -105,10 +134,12 @@ HOW IT WORKS
     Graveyards — markers on files where workers previously failed
 
   State Files (.aether/data/):
-    COLONY_STATE.json   Goal, phases, tasks, memory, signals, events
+    COLONY_STATE.json   Goal, phases, tasks, memory, events
     activity.log        Timestamped worker activity
     spawn-tree.txt      Worker spawn hierarchy
-    constraints.json    Focus/redirect pheromone data
+    pheromones.json     Active FOCUS/REDIRECT/FEEDBACK signals
+    constraints.json    Compatibility mirror for focus/redirect data
+
 
 OPENCODE USERS
 
@@ -121,4 +152,6 @@ OPENCODE USERS
 
   Without quotes, only the first word may be captured. This is now handled
   automatically by the normalize-args utility, but quoting is recommended.
+
 ```
+

package/.opencode/commands/ant/history.md

@@ -1,8 +1,15 @@
+<!-- Generated from .aether/commands/history.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:history
 description: "📜🐜📜 Show colony event history"
 ---
 
+### 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**. Show colony history.
 
 ## Instructions
@@ -125,3 +132,5 @@ Show total event count at the end:
 ```
 Total events recorded: <count>
 ```
+
+

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

@@ -0,0 +1,68 @@
+<!-- Generated from .aether/commands/import-signals.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:import-signals
+description: "Import pheromone signals from another colony's XML export"
+---
+
+### 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**. Import pheromone signals from another colony's XML export.
+
+## Instructions
+
+The arguments are: `$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`:
+- First argument: path to XML file (required).
+- Second argument: colony name/prefix (optional; default: derive from XML filename without extension, or use "imported").
+
+If no arguments provided, show usage and stop:
+```
+Usage: /ant:import-signals <path-to-signals.xml> [colony-name]
+
+  <path-to-signals.xml>  Path to an exported pheromone XML file
+  [colony-name]          Optional prefix for imported signal IDs (prevents collisions)
+
+Example:
+  /ant:import-signals .aether/exchange/pheromones.xml partner-colony
+```
+
+Verify the XML file exists. If not -> "File not found: <path>", stop.
+
+### Step 2: Import
+
+Run using the Bash tool with description "Importing pheromone signals from XML...":
+```bash
+bash .aether/aether-utils.sh pheromone-import-xml "<xml_path>" "<colony_prefix>"
+```
+
+Parse the returned JSON:
+- If `.ok` is `true`: extract `.result.signal_count` and `.result.source`.
+- If `.ok` is `false`: check `.error` for details. If error mentions `xmllint` or `E_FEATURE_UNAVAILABLE`, display: "XML import 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:
+```
+Pheromone signals imported
+
+  Source: <xml_path>
+  Signals imported: <signal_count>
+  Colony prefix: <colony_prefix>
+
+Note: On signal ID collision, current colony signals take priority.
+```
+
+
+