aether-colony 5.1.0 → 5.3.0

package/.aether/commands/opencode/history.md

@@ -0,0 +1,136 @@
+<!-- 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
+
+### Step 1: Read State
+
+Read `.aether/data/COLONY_STATE.json`.
+
+If file missing or `goal: null`:
+```
+No colony initialized. Run /ant:init first.
+```
+Stop here.
+
+### Step 2: Parse Events
+
+Extract the `events` array from the state.
+
+Each event is in format: `timestamp|type|source|description`
+
+Parse each event into components:
+- timestamp: before first `|`
+- type: between first and second `|`
+- source: between second and third `|`
+- description: after third `|`
+
+### Step 3: Parse Filter Arguments
+
+Parse optional filter arguments:
+
+**Event Type Filter:**
+- `--type TYPE` or `-t TYPE`: Filter by event type
+- Multiple types can be specified (comma-separated)
+- Valid types: `colony_initialized`, `phase_started`, `phase_advanced`, `plan_generated`, `milestone_reached`, `state_upgraded`
+
+**Date Range Filter:**
+- `--since DATE`: Show events since DATE
+  - ISO format: `2026-02-13`, `2026-02-13T14:30:00`
+  - Relative: `1d` (1 day ago), `2h` (2 hours ago), `30m` (30 minutes ago)
+- `--until DATE`: Show events until DATE
+  - Same format options as `--since`
+
+### Step 4: Apply Limit
+
+Parse optional `--limit N` argument (default: 10).
+
+If `--limit` is provided, only show N events.
+
+### Step 5: Filter Events
+
+Apply filters to the events array:
+
+**Type Filtering:**
+- If `--type` is provided, split by comma to get list of types
+- Filter events to only include those where type matches any of the specified types (case-insensitive)
+
+**Date Range Filtering:**
+- For `--since`: Parse the date value
+  - If relative (e.g., "1d", "2h", "30m"), calculate timestamp by subtracting from current time
+  - If ISO format, parse directly
+  - Filter events with timestamp >= since date
+- For `--until`: Same parsing logic
+  - Filter events with timestamp <= until date
+
+**Track Active Filters:**
+- Record which filters are active for display indicator
+
+### Step 6: Sort and Display
+
+Sort events in reverse chronological order (most recent first).
+
+If events array is empty:
+```
+No colony events recorded yet.
+```
+
+**Filter Indicators:**
+- If any filters are active, show at the top:
+  - Type filter: `Filters: type=<TYPE>[,<TYPE>...]`
+  - Since filter: `Filters: since=<DATE>`
+  - Until filter: `Filters: until=<DATE>`
+  - Multiple filters: Combine on same line (e.g., `Filters: type=phase_started,phase_advanced since=1d`)
+- Show filtered count: "Showing X of Y events (filtered from Z total)"
+
+Otherwise, display in format:
+```
+━━━ Colony History (most recent first) ━━━
+
+[TIMESTAMP] [TYPE] from [SOURCE]
+  Description: [description]
+
+[TIMESTAMP] [TYPE] from [SOURCE]
+  Description: [description]
+
+... (up to limit)
+```
+
+**Format:**
+- Timestamp: Show in readable format (e.g., "2026-02-13 14:30:00")
+- Type: Uppercase event type
+- Source: Italics for source
+- Description: Plain text
+
+**Event type icons:**
+- `colony_initialized`: 🏠
+- `phase_started`: 🚀
+- `phase_advanced`: ➡️
+- `plan_generated`: 📋
+- `milestone_reached`: 🏆
+- `state_upgraded`: 🔄
+- `default`: 📌
+
+**Limit display:**
+- If filtering is active, show: "Showing X of Y events (filtered from Z total)"
+- If only limit is applied (no filters), show: "Showing X of Y events"
+
+### Step 7: Display Summary
+
+Show total event count at the end:
+```
+Total events recorded: <count>
+```
+
+

package/.aether/commands/opencode/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.
+```
+
+
+