aether-colony 3.1.17 → 5.0.0

package/.opencode/commands/ant/update.md

@@ -28,7 +28,20 @@ Stop here. Do not proceed.
 
 Read the `version` field — this is the **available version**.
 
-### Step 2: Check Current Version
+### Step 2: Check Pending State and Current Version
+
+First, check for a pending sentinel using the Bash tool:
+
+```bash
+test -f .aether/.update-pending && echo "PENDING" || echo "CLEAN"
+```
+
+If output is "PENDING":
+- Output: `Detected incomplete update, re-syncing...`
+- Run using the Bash tool: `rm -f .aether/.update-pending`
+- Skip the version comparison entirely — proceed directly to Step 3.
+
+If output is "CLEAN":
 
 Use the Read tool to read `.aether/version.json`.
 
@@ -38,7 +51,7 @@ Otherwise, read the `version` field — this is the **current version**.
 If current version equals available version, output:
 
 ```
-Already up-to-date (v{version}).
+Already up to date (v{version}).
 
 System files and commands match the global hub.
 Colony data (.aether/data/) is always untouched by updates.
@@ -46,21 +59,46 @@ Colony data (.aether/data/) is always untouched by updates.
 
 Stop here. Do not proceed.
 
-### Step 3: Bootstrap System Files
+### Step 3: Sync System Files from Hub
 
-If `.aether/aether-utils.sh` does not exist yet (new repo that predates the hub), copy it from the hub first:
-```
-cp ~/.aether/system/aether-utils.sh .aether/aether-utils.sh && chmod +x .aether/aether-utils.sh
+The hub stores all system files at `~/.aether/system/`.
+
+Run ONE bash command that syncs everything:
+
+```bash
+mkdir -p .aether/docs .aether/utils .aether/templates .aether/schemas .aether/exchange && \
+cp -f ~/.aether/system/aether-utils.sh .aether/ && \
+cp -f ~/.aether/system/workers.md .aether/ 2>/dev/null || true && \
+cp -f ~/.aether/system/CONTEXT.md .aether/ 2>/dev/null || true && \
+cp -f ~/.aether/system/model-profiles.yaml .aether/ 2>/dev/null || true && \
+cp -Rf ~/.aether/system/docs/* .aether/docs/ 2>/dev/null || true && \
+cp -Rf ~/.aether/system/utils/* .aether/utils/ 2>/dev/null || true && \
+cp -Rf ~/.aether/system/templates/* .aether/templates/ 2>/dev/null || true && \
+cp -Rf ~/.aether/system/schemas/* .aether/schemas/ 2>/dev/null || true && \
+cp -Rf ~/.aether/system/exchange/* .aether/exchange/ 2>/dev/null || true && \
+chmod +x .aether/aether-utils.sh && \
+echo "System files synced"
 ```
 
-Then run using the Bash tool:
+Colony data (`.aether/data/`) is never touched.
+
+If any sync step fails, output:
 ```
-bash .aether/aether-utils.sh bootstrap-system
+Update couldn't finish — some files didn't copy. Run /ant:update again to retry.
 ```
 
-This copies system files (docs, utils, aether-utils.sh) from `~/.aether/system/` into `.aether/` using an explicit allowlist. Colony data is never touched.
+### Step 3.5: Sync Rules to .claude/rules/
 
-Parse the JSON output to get the count of copied files.
+Rules files teach Claude Code about the colony system. Sync them from the hub:
+
+```bash
+# Sync rules if hub has them
+if [ -d ~/.aether/system/rules ]; then
+  mkdir -p .claude/rules
+  cp -Rf ~/.aether/system/rules/* .claude/rules/ 2>/dev/null || true
+  echo "Rules synced"
+fi
+```
 
 ### Step 4: Sync Commands (with orphan cleanup)
 
@@ -71,29 +109,29 @@ For each directory pair, run using the Bash tool:
 ```bash
 # Sync Claude commands
 mkdir -p .claude/commands/ant
-cp -R ~/.aether/commands/claude/* .claude/commands/ant/ 2>/dev/null
+cp -R ~/.aether/system/commands/claude/* .claude/commands/ant/ 2>/dev/null
 # Remove orphans: files in dest that aren't in hub
 comm -23 \
   <(cd .claude/commands/ant && find . -type f ! -name '.*' | sort) \
-  <(cd ~/.aether/commands/claude && find . -type f ! -name '.*' | sort) \
+  <(cd ~/.aether/system/commands/claude && find . -type f ! -name '.*' | sort) \
   | while read f; do rm ".claude/commands/ant/$f" && echo "  removed stale: .claude/commands/ant/$f"; done
 echo "claude: done"
 
 # Sync OpenCode commands
 mkdir -p .opencode/commands/ant
-cp -R ~/.aether/commands/opencode/* .opencode/commands/ant/ 2>/dev/null
+cp -R ~/.aether/system/commands/opencode/* .opencode/commands/ant/ 2>/dev/null
 comm -23 \
   <(cd .opencode/commands/ant && find . -type f ! -name '.*' | sort) \
-  <(cd ~/.aether/commands/opencode && find . -type f ! -name '.*' | sort) \
+  <(cd ~/.aether/system/commands/opencode && find . -type f ! -name '.*' | sort) \
   | while read f; do rm ".opencode/commands/ant/$f" && echo "  removed stale: .opencode/commands/ant/$f"; done
 echo "opencode: done"
 
 # Sync agents
 mkdir -p .opencode/agents
-cp -R ~/.aether/agents/* .opencode/agents/ 2>/dev/null
+cp -R ~/.aether/system/agents/* .opencode/agents/ 2>/dev/null
 comm -23 \
   <(cd .opencode/agents && find . -type f ! -name '.*' | sort) \
-  <(cd ~/.aether/agents && find . -type f ! -name '.*' | sort) \
+  <(cd ~/.aether/system/agents && find . -type f ! -name '.*' | sort) \
   | while read f; do rm ".opencode/agents/$f" && echo "  removed stale: .opencode/agents/$f"; done
 echo "agents: done"
 ```
@@ -117,6 +155,11 @@ Then use the Write tool to write `.aether/version.json`:
 }
 ```
 
+Then delete any leftover pending sentinel (update is now complete) using the Bash tool:
+```bash
+rm -f .aether/.update-pending
+```
+
 ### Step 6: Display Summary
 
 Output:

package/CHANGELOG.md

@@ -5,6 +5,85 @@ All notable changes to the Aether Colony project will be documented in this file
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Changed
+- README updated to v5.0.0
+
+---
+
+## v5.0.0 — Worker Emergence (2026-02-20)
+
+**Major milestone:** Every ant caste is now a real Claude Code subagent. 22 agents ship through the hub, ready for resolution via the Task tool.
+
+### Added
+- **22 Claude Code subagents**: Every ant caste is now a first-class subagent resolvable via the Task tool
+  - Core: Builder, Watcher
+  - Orchestration: Queen, Scout, Route-Setter, 4 Surveyors (nest, disciplines, pathogens, provisions)
+  - Specialists: Keeper, Tracker, Probe, Weaver, Auditor
+  - Niche: Chaos, Archaeologist, Gatekeeper, Includer, Measurer, Sage, Ambassador, Chronicler
+- **Agent distribution pipeline**: `npm install -g .` syncs agents to hub at `~/.aether/system/agents-claude/`, `aether update` delivers to target repos
+- **6 AVA tests for agent quality**: Frontmatter validation, tool restrictions, naming conventions, content standards
+- **repo-structure.md**: Quick re-orientation guide for the codebase
+
+### Fixed
+- **Bash line wrapping bug**: Fixed 58 instances across 7 command files where description text was inside code blocks causing "with: command not found" errors
+- **Lint regression test**: CLEAN-03 test scans both Claude and OpenCode command directories
+
+### Changed
+- **.aether/docs/ curated**: 8 keepers at root, 6 archived for reference
+- **README.md updated**: Action-oriented tone, v5.0 agent capabilities featured, caste table by tier
+- **ROADMAP.md and STATE.md**: v5.0 marked shipped, all 31 phases complete at 100%
+
+### Phases Shipped
+- **Phase 27**: Distribution Infrastructure + First Core Agents (4 plans)
+- **Phase 28**: Orchestration Layer + Surveyor Variants (3 plans)
+- **Phase 29**: Specialist Agents + Agent Tests (3 plans)
+- **Phase 30**: Niche Agents (3 plans)
+- **Phase 31**: Integration Verification + Cleanup (3 plans)
+
+---
+
+### Removed
+- Old planning phases 10-19 archived to docs/plans/ (completed phases)
+- Orphaned worktree salvage files moved to docs/worktree-salvage/
+
+---
+
+## v4.0.0 -- Distribution Simplification
+
+**Breaking change:** The `runtime/` staging directory has been removed. The npm package now reads directly from `.aether/`, with private directories (data/, dreams/, oracle/, etc.) excluded by `.aether/.npmignore`.
+
+### Changed
+- `.aether/` is now directly included in the npm package (private dirs excluded by `.aether/.npmignore`)
+- `bin/validate-package.sh` replaces `bin/sync-to-runtime.sh` — validates required files, no copying
+- Hub sync uses exclude-based approach instead of triplicate 59-62 file allowlists
+- Pre-commit hook repurposed for validation (no more runtime/ sync)
+- `aether update` uses `syncAetherToRepo` (exclude-based) for all system file distribution
+- All three distribution paths (system files, commands, agents) unified in `setupHub()`
+
+### Removed
+- `runtime/` staging directory — eliminated entirely
+- `bin/sync-to-runtime.sh` — replaced by validation-only script
+- `SYSTEM_FILES` allowlist arrays in cli.js and update-transaction.js
+- `copySystemFiles()` and `syncSystemFilesWithCleanup()` functions
+
+### Added
+- `bin/validate-package.sh` — pre-packaging validation with `--dry-run` mode
+- Private data exposure guard — blocks packaging if .npmignore doesn't cover private dirs
+- Migration message for users upgrading from v3.x
+- `npm pack --dry-run` recommended for verifying package contents
+
+### Fixed
+- ISSUE-004: Template path hardcoded to runtime/ — resolved by eliminating runtime/ entirely
+
+### Migration
+- Run `npm install -g aether-colony` to get v4.0
+- Your colony state and data are unaffected
+- The only change is how the package is built — distributed content is identical
+
+---
+
 ## [3.1.5] - 2026-02-15
 
 ### Fixed