aether-colony 1.1.0

package/.aether/model-profiles.yaml

@@ -0,0 +1,100 @@
+version: '1.0'
+description: Default model assignments for Aether colony workers
+profile: default
+worker_models:
+  prime: glm-5
+  archaeologist: glm-5
+  architect: glm-5
+  oracle: minimax-2.5
+  route_setter: kimi-k2.5
+  builder: kimi-k2.5
+  watcher: kimi-k2.5
+  scout: kimi-k2.5
+  chaos: kimi-k2.5
+  colonizer: kimi-k2.5
+model_metadata:
+  glm-5:
+    description: '744B MoE model (40B active), long-horizon agentic engineering'
+    provider: z_ai
+    capabilities:
+      - planning
+      - coordination
+      - long_context
+      - complex_reasoning
+      - agentic_workflows
+    context_window: 200000
+    speed: medium
+    cost_tier: high
+    best_for:
+      - 'Long-horizon task execution (tested: 1 year business simulation)'
+      - Strategic coordination and planning
+      - Historical pattern analysis across large contexts
+      - Multi-step autonomous workflows
+  minimax-2.5:
+    description: Frontier model for architectural planning and agentic tool use
+    provider: minimax
+    capabilities:
+      - system_design
+      - architecture
+      - browse
+      - search
+      - task_decomposition
+    context_window: 200000
+    speed: fast
+    cost_tier: medium
+    best_for:
+      - Architectural-level planning and system design
+      - Research with browse/search (76.3% BrowseComp)
+      - Efficient task decomposition (20% fewer search rounds)
+      - Full-stack development (80.2% SWE-Bench Verified)
+  kimi-k2.5:
+    description: '1T MoE model (32B active), multimodal agent with swarm capabilities'
+    provider: kimi
+    capabilities:
+      - coding
+      - multimodal
+      - agent_swarm
+      - visual_coding
+      - validation
+    context_window: 256000
+    speed: fast
+    cost_tier: low
+    best_for:
+      - Code generation and refactoring (76.8% SWE-Bench)
+      - Visual coding (screenshots to code)
+      - Parallel exploration (up to 100 sub-agents)
+      - Validation and testing workflows
+task_routing:
+  default_model: kimi-k2.5
+  complexity_indicators:
+    complex:
+      keywords:
+        - design
+        - architecture
+        - plan
+        - coordinate
+        - synthesize
+        - strategize
+        - optimize
+      model: glm-5
+    simple:
+      keywords:
+        - implement
+        - code
+        - refactor
+        - write
+        - create
+      model: kimi-k2.5
+    validate:
+      keywords:
+        - test
+        - validate
+        - verify
+        - check
+        - review
+        - audit
+      model: minimax-2.5
+proxy:
+  endpoint: 'http://localhost:4000'
+  auth_token: ${LITELLM_AUTH_TOKEN:-sk-litellm-local}
+  health_check: 'http://localhost:4000/health'

package/.aether/rules/aether-colony.md

@@ -0,0 +1,134 @@
+# Aether Colony System
+
+> This repo uses the Aether colony system for multi-agent development.
+> These rules are auto-distributed by `aether update` — do not edit directly.
+
+## Session Recovery
+
+On the first message of a new conversation, check if `.aether/data/session.json` exists. If it does:
+
+1. Read the file briefly to check for `colony_goal`
+2. If a goal exists, display:
+   ```
+   Previous colony session detected: "{goal}"
+   Run /ant:resume to restore context, or continue with a new topic.
+   ```
+3. Do NOT auto-restore — wait for the user to explicitly run /ant:resume
+
+This only applies to genuinely new conversations, not after /clear.
+
+## Available Commands
+
+### Getting Started
+| Command | Purpose |
+|---------|---------|
+| `/ant:init "<goal>"` | Set colony intention and initialize |
+| `/ant:colonize` | Analyze existing codebase |
+| `/ant:plan` | Generate project phases |
+| `/ant:build <phase>` | Execute a phase with parallel workers |
+| `/ant:continue` | Verify work, extract learnings, advance |
+
+### Pheromone Signals
+| Command | Priority | Purpose |
+|---------|----------|---------|
+| `/ant:focus "<area>"` | normal | Guide colony attention |
+| `/ant:redirect "<pattern>"` | high | Hard constraint — avoid this |
+| `/ant:feedback "<note>"` | low | Gentle adjustment |
+
+### Status & Monitoring
+| Command | Purpose |
+|---------|---------|
+| `/ant:status` | Colony dashboard |
+| `/ant:phase [N]` | View phase details |
+| `/ant:flags` | List active flags |
+| `/ant:flag "<title>"` | Create a flag |
+| `/ant:history` | Browse colony events |
+| `/ant:watch` | Live tmux monitoring |
+
+### Session Management
+| Command | Purpose |
+|---------|---------|
+| `/ant:pause-colony` | Save state and create handoff |
+| `/ant:resume-colony` | Restore from pause |
+| `/ant:resume` | Quick session restore |
+
+### Lifecycle
+| Command | Purpose |
+|---------|---------|
+| `/ant:seal` | Seal colony (Crowned Anthill) |
+| `/ant:entomb` | Archive completed colony |
+| `/ant:maturity` | View colony maturity journey |
+| `/ant:update` | Update system files from hub |
+
+### Advanced
+| Command | Purpose |
+|---------|---------|
+| `/ant:swarm "<bug>"` | Parallel bug investigation |
+| `/ant:oracle` | Deep research (RALF loop) |
+| `/ant:dream` | Philosophical observation |
+| `/ant:interpret` | Review dreams, discuss actions |
+| `/ant:chaos` | Resilience testing |
+| `/ant:archaeology` | Git history analysis |
+| `/ant:organize` | Codebase hygiene report |
+| `/ant:council` | Intent clarification |
+
+## Typical Workflow
+
+```
+/ant:init "Build feature X"    → Set colony goal
+/ant:colonize                  → Understand existing code (optional)
+/ant:plan                      → Generate phases
+/ant:focus "security"          → Steer attention (optional)
+/ant:build 1                   → Execute phase 1
+/ant:continue                  → Verify, learn, advance
+/ant:build 2                   → Execute phase 2
+...repeat until complete...
+/ant:seal                      → Seal completed colony
+```
+
+After `/clear` or session break: `/ant:resume-colony` to restore context.
+
+## Worker Castes
+
+Workers are assigned to castes based on task type:
+
+| Caste | Role |
+|-------|------|
+| builder | Implementation work |
+| watcher | Monitoring, quality checks |
+| scout | Research, discovery |
+| chaos | Edge case testing |
+| oracle | Deep research (RALF loop) |
+| architect | Planning, design |
+| colonizer | Codebase exploration |
+| route_setter | Phase planning |
+| archaeologist | Git history analysis |
+
+## Protected Paths
+
+**Never modify these programmatically:**
+
+| Path | Reason |
+|------|--------|
+| `.aether/data/` | Colony state (COLONY_STATE.json, session files) |
+| `.aether/dreams/` | Dream journal entries |
+| `.aether/checkpoints/` | Session checkpoints |
+| `.aether/locks/` | File locks |
+
+## Colony State
+
+State is stored in `.aether/data/COLONY_STATE.json` and includes:
+- Colony goal and current phase
+- Task breakdown and completion status
+- Instincts (learned patterns with confidence scores)
+- Pheromone signals (FOCUS/REDIRECT/FEEDBACK)
+- Event history
+
+## Pheromone System
+
+Signals guide colony behavior without hard-coding instructions:
+- **FOCUS** — attracts attention to an area (expires at phase end)
+- **REDIRECT** — repels workers from a pattern (high priority, hard constraint)
+- **FEEDBACK** — calibrates behavior based on observation (low priority)
+
+Use FOCUS + REDIRECT before builds to steer. Use FEEDBACK after builds to adjust.

package/.aether/schemas/aether-types.xsd

@@ -0,0 +1,255 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Aether Shared Types Schema
+
+  Purpose: Define common types used across all Aether Colony schemas.
+           Eliminates duplication of caste enumerations, version patterns,
+           and other shared type definitions.
+
+  Usage: Import into other schemas:
+    <xs:import namespace="http://aether.colony/schemas/types/1.0"
+               schemaLocation="aether-types.xsd"/>
+
+  Version: 1.0.0
+  Namespace: http://aether.colony/schemas/types/1.0
+-->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+           targetNamespace="http://aether.colony/schemas/types/1.0"
+           xmlns:types="http://aether.colony/schemas/types/1.0"
+           elementFormDefault="qualified">
+
+  <xs:annotation>
+    <xs:documentation>
+      Shared type definitions for the Aether Colony XML schema ecosystem.
+      Import this schema to use standardized types for castes, versions,
+      timestamps, priorities, and pheromone signal types.
+    </xs:documentation>
+  </xs:annotation>
+
+  <!-- ============================================================ -->
+  <!-- Caste Enumeration (Source of Truth)                          -->
+  <!-- ============================================================ -->
+
+  <xs:simpleType name="CasteEnum">
+    <xs:annotation>
+      <xs:documentation>
+        Complete enumeration of all worker castes in the Aether Colony system.
+        This is the single source of truth for caste definitions across all schemas.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="builder"/>
+      <xs:enumeration value="watcher"/>
+      <xs:enumeration value="scout"/>
+      <xs:enumeration value="chaos"/>
+      <xs:enumeration value="oracle"/>
+      <xs:enumeration value="architect"/>
+      <xs:enumeration value="prime"/>
+      <xs:enumeration value="colonizer"/>
+      <xs:enumeration value="route_setter"/>
+      <xs:enumeration value="archaeologist"/>
+      <xs:enumeration value="ambassador"/>
+      <xs:enumeration value="auditor"/>
+      <xs:enumeration value="chronicler"/>
+      <xs:enumeration value="gatekeeper"/>
+      <xs:enumeration value="guardian"/>
+      <xs:enumeration value="includer"/>
+      <xs:enumeration value="keeper"/>
+      <xs:enumeration value="measurer"/>
+      <xs:enumeration value="probe"/>
+      <xs:enumeration value="sage"/>
+      <xs:enumeration value="tracker"/>
+      <xs:enumeration value="weaver"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ============================================================ -->
+  <!-- Version and Timestamp Types                                  -->
+  <!-- ============================================================ -->
+
+  <xs:simpleType name="VersionType">
+    <xs:annotation>
+      <xs:documentation>
+        Semantic version string format (e.g., 1.0.0, 2.1.3-alpha)
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:pattern value="[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9]+)?"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="TimestampType">
+    <xs:annotation>
+      <xs:documentation>
+        ISO 8601 timestamp format with optional milliseconds and timezone
+        Examples: 2026-02-16T14:30:00Z, 2026-02-16T14:30:00.123+01:00
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:pattern value="\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ============================================================ -->
+  <!-- Priority and Signal Types                                    -->
+  <!-- ============================================================ -->
+
+  <xs:simpleType name="PriorityType">
+    <xs:annotation>
+      <xs:documentation>
+        Priority levels for signals, tasks, and various colony operations.
+        Ordered from highest to lowest urgency.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="critical"/>
+      <xs:enumeration value="high"/>
+      <xs:enumeration value="normal"/>
+      <xs:enumeration value="low"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="PheromoneTypeEnum">
+    <xs:annotation>
+      <xs:documentation>
+        Types of pheromone signals used in colony communication.
+        These directional signals guide worker behavior without direct commands.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="FOCUS"/>
+      <xs:enumeration value="REDIRECT"/>
+      <xs:enumeration value="FEEDBACK"/>
+      <xs:enumeration value="PHILOSOPHY"/>
+      <xs:enumeration value="STACK"/>
+      <xs:enumeration value="PATTERN"/>
+      <xs:enumeration value="DECREE"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ============================================================ -->
+  <!-- Identifier Types                                             -->
+  <!-- ============================================================ -->
+
+  <xs:simpleType name="IdentifierType">
+    <xs:annotation>
+      <xs:documentation>
+        Standard identifier format: alphanumeric with hyphens and underscores.
+        Must start with a letter. Used for IDs, keys, and references.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:pattern value="[a-zA-Z][a-zA-Z0-9_-]*"/>
+      <xs:minLength value="1"/>
+      <xs:maxLength value="64"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="WorkerIdType">
+    <xs:annotation>
+      <xs:documentation>
+        Worker-specific identifier in kebab-case format.
+        Must be at least 3 characters for readability.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:pattern value="[a-z][a-z0-9-]*"/>
+      <xs:minLength value="3"/>
+      <xs:maxLength value="64"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="WisdomIdType">
+    <xs:annotation>
+      <xs:documentation>
+        Wisdom entry identifier in kebab-case format.
+        Used for queen-wisdom entries and patterns.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:pattern value="[a-z][a-z0-9-]*"/>
+      <xs:minLength value="3"/>
+      <xs:maxLength value="64"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ============================================================ -->
+  <!-- Weight and Confidence Types                                  -->
+  <!-- ============================================================ -->
+
+  <xs:simpleType name="WeightType">
+    <xs:annotation>
+      <xs:documentation>
+        Weight value for tags and priorities, range 0.0 to 1.0.
+        Stored with 2 decimal places of precision.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:decimal">
+      <xs:minInclusive value="0.0"/>
+      <xs:maxInclusive value="1.0"/>
+      <xs:fractionDigits value="2"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="ConfidenceType">
+    <xs:annotation>
+      <xs:documentation>
+        Confidence score for wisdom entries and patterns, range 0.0 to 1.0.
+        Stored with 2 decimal places of precision.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:decimal">
+      <xs:minInclusive value="0.0"/>
+      <xs:maxInclusive value="1.0"/>
+      <xs:fractionDigits value="2"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ============================================================ -->
+  <!-- Match and Source Types                                       -->
+  <!-- ============================================================ -->
+
+  <xs:simpleType name="MatchEnum">
+    <xs:annotation>
+      <xs:documentation>
+        Match mode for scope filtering: any (at least one), all (all required),
+        or none (exclude matching).
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="any"/>
+      <xs:enumeration value="all"/>
+      <xs:enumeration value="none"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="SourceTypeEnum">
+    <xs:annotation>
+      <xs:documentation>
+        Source of a signal or entry: user-created, worker-generated,
+        system-originated, or from external integration.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="user"/>
+      <xs:enumeration value="worker"/>
+      <xs:enumeration value="system"/>
+      <xs:enumeration value="external"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <xs:simpleType name="DataFormatEnum">
+    <xs:annotation>
+      <xs:documentation>
+        Format of structured data attachments.
+      </xs:documentation>
+    </xs:annotation>
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="json"/>
+      <xs:enumeration value="xml"/>
+      <xs:enumeration value="yaml"/>
+      <xs:enumeration value="plain"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+</xs:schema>