aether-colony 5.0.0 → 5.2.1

package/.opencode/commands/ant/flags.md

@@ -1,18 +1,19 @@
+<!-- Generated from .aether/commands/flags.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:flags
 description: "📋🐜🚩🐜📋 List project flags (blockers, issues, notes)"
 ---
 
-You are the **Queen**. Display project flags.
-
-## 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**. Display project flags.
+
+## Instructions
+
 Arguments: `$normalized_args`
 
 ### Step 1: Parse Arguments
@@ -33,7 +34,10 @@ Examples:
 
 ### Step 2: Handle Resolution/Acknowledgment
 
+
+
 If `--resolve` was provided:
+
 ```bash
 bash .aether/aether-utils.sh flag-resolve "{flag_id}" "{resolution_message}"
 ```
@@ -45,7 +49,10 @@ Output:
 ```
 Stop here.
 
+
+
 If `--ack` was provided:
+
 ```bash
 bash .aether/aether-utils.sh flag-acknowledge "{flag_id}"
 ```
@@ -59,7 +66,10 @@ Stop here.
 
 ### Step 3: List Flags
 
+
+
 Run:
+
 ```bash
 bash .aether/aether-utils.sh flag-list {options}
 ```
@@ -70,19 +80,21 @@ Parse result for flags array.
 
 Output header:
 
+
+
 ```
 📋🐜🚩🐜📋 ═══════════════════════════════════════════════════
    P R O J E C T   F L A G S
 ═══════════════════════════════════════════════════ 📋🐜🚩🐜📋
-```
+
 
 If no flags:
 ```
        .-.
       (o o)  AETHER COLONY
       | O |  Flags
-       `-`
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+       `-"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 ✨ No active flags! Colony is clear.
 
@@ -94,8 +106,8 @@ If flags exist:
        .-.
       (o o)  AETHER COLONY
       | O |  Flags
-       `-`
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+       `-"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 {for each flag, grouped by type:}
 
@@ -120,7 +132,7 @@ If flags exist:
    {flag_id}: {title}
    Resolved: {date} | {resolution}
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Summary: {blockers} blockers | {issues} issues | {notes} notes
 
@@ -133,6 +145,8 @@ Commands:
   /ant:flag "description"               Create new flag
 ```
 
+
+
 ---
 
 ## Quick Actions

package/.opencode/commands/ant/focus.md

@@ -1,18 +1,22 @@
+<!-- Generated from .aether/commands/focus.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:focus
 description: "🔦🐜🔍🐜🔦 Emit FOCUS signal to guide colony attention"
 ---
 
-You are the **Queen**. Add a FOCUS constraint.
-
-## 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**. Add a FOCUS constraint.
+
+
+## Instructions
+
 The focus area is: `$normalized_args`
 
 ### Step 1: Validate
@@ -20,11 +24,15 @@ The focus area is: `$normalized_args`
 If `$normalized_args` empty -> show usage: `/ant:focus <area>`, stop.
 If content > 500 chars -> "Focus content too long (max 500 chars)", stop.
 
-### Step 2: Read + Update Constraints
+
+
+### Step 2: Write Signal
 
 Read `.aether/data/COLONY_STATE.json`.
 If `goal: null` -> "No colony initialized.", stop.
 
+
+
 Read `.aether/data/constraints.json`. If file doesn't exist, create it with:
 ```json
 {"version": "1.0", "focus": [], "constraints": []}
@@ -36,6 +44,12 @@ If `focus` array exceeds 5 entries, remove the oldest entries to keep only 5.
 
 Write constraints.json.
 
+**Write pheromone signal and update context:**
+```bash
+bash .aether/aether-utils.sh pheromone-write FOCUS "$normalized_args" --strength 0.8 --reason "User directed colony attention" 2>/dev/null || true
+bash .aether/aether-utils.sh context-update constraint focus "$normalized_args" "user" 2>/dev/null || true
+```
+
 ### Step 3: Confirm
 
 Output header:
@@ -54,3 +68,6 @@ Then output:
 
 🐜 Colony attention directed.
 ```
+
+
+

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.
+```
+
+
+