aether-colony 5.0.0 → 5.1.0

package/.aether/commands/update.yaml

@@ -0,0 +1,131 @@
+name: "ant:update"
+description: "🔄🐜📦🐜🔄 Update Aether safely from the global hub (transactional)"
+body: |
+  You are the **Queen Ant Colony**. Update this repo's Aether system files from the global distribution hub.
+
+  ## Safety Rules
+
+  1. Use the CLI transactional updater (`aether update`) instead of manual `cp` chains.
+  2. Never overwrite colony runtime data (`.aether/data/`) or user wisdom (`.aether/QUEEN.md`).
+  3. Do **not** assume version numbers are monotonic. Labels may reset; avoid "downgrade" wording.
+  4. If update reports dirty managed files, stop and show recovery options unless user requested force.
+
+  ## Instructions
+
+  ### Step 1: Check Hub Availability
+
+  {{TOOL_PREFIX "Checking Aether hub..."}}
+
+  ```bash
+  test -f ~/.aether/version.json && cat ~/.aether/version.json || echo "__NO_HUB__"
+  ```
+
+  If output is `__NO_HUB__`, display:
+
+  ```
+  No Aether distribution hub found at ~/.aether/
+
+  To set up the hub, run:
+    npx aether-colony install
+    - or -
+    aether install
+  ```
+
+  Stop here.
+
+  Parse `version` from the JSON as `available_version`.
+
+  ### Step 1.5: Verify CLI Availability
+
+  {{TOOL_PREFIX "Checking aether CLI..."}}
+
+  ```bash
+  command -v aether >/dev/null 2>&1 && echo "__CLI_OK__" || echo "__CLI_MISSING__"
+  ```
+
+  If output is `__CLI_MISSING__`, display:
+
+  ```
+  The transactional updater is not available because the `aether` CLI is missing.
+
+  Install/update it, then retry:
+    npx aether-colony install
+    - or -
+    npm i -g aether-colony
+  ```
+
+  Stop here.
+
+  ### Step 2: Parse Force Flag
+
+  Treat either of these as force:
+  - `--force`
+  - `--force-update`
+
+  Set:
+  - `update_flags="--force"` when force requested
+  - `update_flags=""` otherwise
+
+  ### Step 3: Dry-Run Preview
+
+  {{TOOL_PREFIX "Previewing update..."}}
+
+  ```bash
+  aether update --dry-run $update_flags
+  ```
+
+  If this fails, show the error output and stop.
+
+  ### Step 4: Execute Transactional Update
+
+  {{TOOL_PREFIX "Applying update..."}}
+
+  ```bash
+  aether update $update_flags
+  ```
+
+  This command handles:
+  - checkpoint creation
+  - safe sync
+  - integrity verification
+  - automatic rollback on failure
+
+  ### Step 5: Clear Version Cache
+
+  {{#claude}}
+  Run using the Bash tool:
+  {{/claude}}
+  {{#opencode}}
+  Run:
+  {{/opencode}}
+
+  ```bash
+  rm -f .aether/data/.version-check-cache
+  ```
+
+  ### Step 6: Display Summary
+
+  Display a concise summary:
+
+  ```
+  🔄🐜📦🐜🔄 AETHER UPDATE COMPLETE
+
+  Hub version label: {available_version}
+  Update mode: {normal|force}
+  Colony data (.aether/data/) untouched.
+
+  Note: version labels are treated as identifiers, not strict upgrade/downgrade ordering.
+  ```
+
+  {{#claude}}
+  ### Next Up
+
+  Generate the state-based Next Up block by running:
+
+  ```bash
+  state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
+  current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
+  total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
+  bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+  ```
+  {{/claude}}

package/.aether/commands/verify-castes.yaml

@@ -0,0 +1,159 @@
+name: "ant:verify-castes"
+description: "Verify colony caste assignments and system status"
+body: |
+  You are the **Queen**. Display the caste assignments and system status.
+
+  ## Step 1: Show Caste Assignments
+
+  Display the colony caste structure as a compact table:
+
+  {{#claude}}
+  ```
+  Aether Colony Caste System
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  {{/claude}}
+  {{#opencode}}
+  ```
+  Aether Colony Caste System
+  ═════════════════════════════════════════
+  {{/opencode}}
+
+  CASTE ASSIGNMENTS
+  ────────────────────────────────────
+  Caste                Slot     Active
+  ────────────────────────────────────
+  [reasoning]
+    Archaeologist      opus     yes
+    Architect          opus     yes
+    Auditor            opus     yes
+    Gatekeeper         opus     yes
+    Measurer           opus     yes
+    Oracle             opus     yes
+    Queen              opus     yes
+    Route-setter       opus     yes
+    Sage               opus     yes
+    Tracker            opus     yes
+  ────────────────────────────────────
+  [execution]
+    Ambassador         sonnet   yes
+    Builder            sonnet   yes
+    Chaos              sonnet   yes
+    Disciplines        sonnet   yes
+    Nest               sonnet   yes
+    Pathogens          sonnet   yes
+    Probe              sonnet   yes
+    Provisions         sonnet   yes
+    Scout              sonnet   yes
+    Weaver             sonnet   yes
+    Watcher            sonnet   yes
+  ────────────────────────────────────
+  [inherit]
+    Chronicler         inherit  yes
+    Includer           inherit  yes
+    Keeper             inherit  yes
+  {{#claude}}
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  {{/claude}}
+  {{#opencode}}
+  ═════════════════════════════════════════
+  {{/opencode}}
+  ```
+
+  Source of truth: Agent frontmatter `model:` fields in `.claude/agents/ant/*.md`.
+  Caste slots come from agent frontmatter (`model:` field).
+
+  ## Step 2: Check System Status
+
+  {{#claude}}
+  Run using the Bash tool with description "Checking colony version...": `bash .aether/aether-utils.sh version-check-cached 2>/dev/null || echo "Utils available"`
+  {{/claude}}
+  {{#opencode}}
+  Run using Bash tool: `bash .aether/aether-utils.sh version-check 2>/dev/null || echo "Utils available"`
+  {{/opencode}}
+
+  Check LiteLLM proxy status:
+  ```bash
+  curl -s http://localhost:4000/health 2>/dev/null | grep -q "healthy" && echo "✓ Proxy healthy" || echo "⚠ Proxy not running"
+  ```
+
+  ## Step 3: Show Current Model Configuration
+
+  Display the active model configuration:
+
+  {{#claude}}
+  ```
+  MODEL CONFIGURATION
+  ──────────────────
+  {{/claude}}
+  {{#opencode}}
+  ```
+  MODEL CONFIGURATION
+  ════════════════════════════════
+  {{/opencode}}
+  Default: Claude API mode (opus -> claude-opus-4, sonnet -> claude-sonnet-4)
+
+  To switch to GLM Proxy mode:
+    cp ~/.claude/settings.json.glm ~/.claude/settings.json
+    (opus -> glm-5, sonnet -> glm-5-turbo, haiku -> glm-4.5-air)
+
+  To switch back to Claude API:
+    cp ~/.claude/settings.json.claude ~/.claude/settings.json
+  {{#claude}}
+  ```
+  {{/claude}}
+  {{#opencode}}
+  ════════════════════════════════
+  {{/opencode}}
+
+  Current model mapping from agent frontmatter:
+  ```bash
+  grep "^model:" .claude/agents/ant/*.md
+  ```
+
+  ## Step 4: Summary
+
+  {{#claude}}
+  ```
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  System Status
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  {{/claude}}
+  {{#opencode}}
+  ```
+  ═══════════════════════════════════════════════════════
+  System Status
+  ═══════════════════════════════════════════════════════
+  {{/opencode}}
+  Utils: ✓ Operational
+  Proxy: {status from Step 2}
+  Castes: 24 defined (10 opus, 11 sonnet, 3 inherit)
+  Routing: Per-caste via agent frontmatter model: field
+  ```
+
+  {{#claude}}
+  ## Step 5: Next Up
+
+  Generate the state-based Next Up block by running using the Bash tool with description "Generating Next Up suggestions...":
+  ```bash
+  state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
+  current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
+  total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
+  bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+  ```
+  {{/claude}}
+
+  ## Historical Note
+
+  Per-caste model routing was initially attempted using environment variable
+  injection at spawn time (archived in `.aether/archive/model-routing/`).
+  That approach failed due to Claude Code Task tool limitations.
+
+  The current approach uses agent frontmatter `model:` fields, which Claude Code
+  handles natively. No Aether code intervention is required -- Claude Code reads
+  the frontmatter and resolves the slot name through `ANTHROPIC_DEFAULT_*_MODEL`
+  environment variables.
+
+  To view the archived v1 configuration:
+  ```bash
+  git show model-routing-v1-archived
+  ```