aether-colony 1.1.0

package/.aether/CONTEXT.md

@@ -0,0 +1,160 @@
+# Aether Colony — Current Context
+
+> **This document is the colony's memory. If context collapses, read this file first.**
+
+---
+
+## 🚦 System Status
+
+| Field | Value |
+|-------|-------|
+| **Last Updated** | 2026-02-16T20:49:16Z |
+| **Current Phase** | - |
+| **Phase Name** | Shellcheck Fixes |
+| **Milestone** | Open Chambers |
+| **Colony Status** | IDLE (No active colony) |
+| **Safe to Clear?** | YES — No active colony - test fixes complete, hooks simplified |
+
+---
+
+## 📝 Session Notes (2026-02-21)
+
+### Completed This Session
+- Fixed shellcheck SC2168 warnings in `.aether/aether-utils.sh`
+- Removed duplicate context-update code (~388 lines)
+- Fixed 8 remaining `local` keyword errors in case handlers
+- All 383 tests pass, 0 SC2168 errors
+
+### Pending Work
+- Commit the shellcheck fixes
+- Resume XML integration work (see prior session handoff)
+
+---
+
+## 🎯 Prior Goal (2026-02-16)
+
+Implement XML exchange system integration into existing colony lifecycle (pause/resume/seal/init) rather than as separate commands.
+
+**Decision needed:** Choose integration approach:
+- **Option A:** Auto-export on pause, auto-import on resume
+- **Option B:** Export to eternal memory on seal, import on init
+- **Option C:** Hybrid approach (recommended)
+
+---
+
+## 📍 What's In Progress
+
+### Phase 4: XML Exchange System ✅ COMPLETE
+
+**Built but not yet integrated:**
+
+1. **Exchange Modules** (`.aether/exchange/`)
+   - `pheromone-xml.sh` - Signal export/import/merge with namespace prefixing
+   - `wisdom-xml.sh` - Queen wisdom with promotion pipeline (0.8 threshold)
+   - `registry-xml.sh` - Colony lineage and ancestry tracking
+
+2. **Core Utilities** (`.aether/utils/xml-core.sh`)
+   - Feature detection for xmllint/xmlstarlet/xsltproc
+   - JSON output helpers
+   - Validation, formatting, escaping
+
+3. **Schemas** (`.aether/schemas/`)
+   - `pheromone.xsd` - 22 castes, 4 priority levels
+   - `queen-wisdom.xsd` - Philosophy/pattern validation
+   - `colony-registry.xsd` - Lineage validation
+   - `aether-types.xsd` - Shared types
+
+4. **Tests**
+   - `tests/bash/test-xml-roundtrip.sh` - 19/19 tests passing
+
+---
+
+## ✅ Completed Work
+
+### Phase 1: Foundation ✅
+- XML validation utilities (xml-validate, xml-query, xml-convert)
+- XSD schemas (pheromone.xsd, queen-wisdom.xsd, colony-registry.xsd)
+- 20/20 tests passing
+
+### Phase 2: Pheromone XML ✅
+- Pheromone export to XML with namespaces
+- XInclude composition for worker priming
+- Colony namespace generation functions
+- 15/15 pheromone tests + 6/6 XInclude tests passing
+
+### Phase 3: Wisdom Evolution ✅
+- XSLT transformation queen-wisdom.xml → QUEEN.md
+- Validation workflow using queen-wisdom.xsd
+- Wisdom promotion pipeline (pattern → philosophy at 0.8 confidence)
+
+### Phase 4: Exchange System ✅
+- Round-trip conversion (JSON ↔ XML)
+- Namespace prefixing for collision prevention
+- Merge with deduplication
+- 19/19 round-trip tests passing
+
+---
+
+## ⚠️ Active Constraints (REDIRECT Signals)
+
+| Constraint | Source | Date Set |
+|------------|--------|----------|
+| In the Aether repo, `.aether/` IS the source of truth — published directly to npm (private dirs excluded by .npmignore) | CLAUDE.md | Permanent |
+| Never push without explicit user approval | CLAUDE.md Safety | Permanent |
+| XML exchange should be automatic, not separate commands | User | 2026-02-16 |
+
+---
+
+## 💭 Active Pheromones (FOCUS Signals)
+
+*None active*
+
+---
+
+## 📝 Recent Decisions
+
+| Date | Decision | Rationale | Made By |
+|------|----------|-----------|---------|
+| 2026-02-16 | Remove /ant:export and /ant:import commands | User wants system integration, not new commands | User |
+| 2026-02-16 | Complete Phase 4 | All exchange modules built and tested | Queen |
+| 2026-02-16 | Pause for integration decision | Need user input on approach (A, B, or C) | Queen |
+
+---
+
+## 📊 Recent Activity (Last 10 Actions)
+
+| Timestamp | Command | Result | Files Changed |
+|-----------|---------|--------|---------------|
+| 2026-02-16T20:49:04Z | pause-colony | Colony paused — test fixes and hook debugging completed | tests fixed: 18→0, hooks simplified |
+| 2026-02-16T20:20:00Z | export/import removed | Commands deleted as requested | -2 files |
+| 2026-02-16T20:18:00Z | registry-xml.sh | Created registry exchange module | +1 file |
+| 2026-02-16T20:15:00Z | wisdom-xml.sh | Created wisdom exchange module | +1 file |
+| 2026-02-16T20:14:00Z | pheromone-xml.sh | Fixed merge tests, 19/19 passing | 1 file |
+| 2026-02-16T20:10:00Z | test-xml-roundtrip.sh | Comprehensive test suite | +1 file |
+| 2026-02-16T20:00:00Z | xml-core.sh | Core XML utilities | +1 file |
+| 2026-02-16T19:50:00Z | schemas/* | XSD schemas for validation | +4 files |
+
+---
+
+## 🔄 Next Steps
+
+**AWAITING USER DECISION:**
+
+How should XML exchange integrate into existing commands?
+
+### Option A: Pause/Resume Integration
+- `/ant:pause-colony` → Auto-export to `.aether/exports/`
+- `/ant:resume-colony` → Check for exports, offer to import
+
+### Option B: Seal/Init Integration
+- `/ant:seal` → Export to `~/.aether/eternal/` (cross-colony)
+- `/ant/init` → Check eternal memory, offer to seed new colony
+
+### Option C: Hybrid (Recommended)
+- **Pause** → Export to `.aether/exports/` (local handoff)
+- **Seal** → Export to `~/.aether/eternal/` (eternal memory)
+- **Resume** → Import from both locations
+- **Init** → Offer eternal memory as seed
+
+---
+

package/.aether/QUEEN.md

@@ -0,0 +1,84 @@
+# QUEEN.md — Colony Wisdom
+
+> Last evolved: 2026-02-15T13:08:15Z
+> Colonies contributed: 0
+> Wisdom version: 1.0.0
+
+---
+
+## 📜 Philosophies
+
+Core beliefs that guide all colony work. These are validated through repeated successful application across multiple colonies.
+
+- **colony-a** (2026-02-15T13:08:24Z): Test-driven development ensures quality
+
+---
+
+## 🧭 Patterns
+
+Validated approaches that consistently work. These represent discovered best practices that have proven themselves in the field.
+
+- **colony-b** (2026-02-15T13:08:28Z): Always validate inputs
+
+---
+
+## ⚠️ Redirects
+
+Anti-patterns to avoid. These represent approaches that have caused problems and should be redirected away from.
+
+- **colony-c** (2026-02-15T13:08:31Z): Never skip security checks
+
+---
+
+## 🔧 Stack Wisdom
+
+Technology-specific insights and constraints detected through codebase analysis.
+
+- **colony-d** (2026-02-15T13:08:36Z): Use jq for JSON in bash
+
+---
+
+## 🏛️ Decrees
+
+User-mandated rules that override other guidance. These represent explicit directives from the Queen.
+
+- **colony-e** (2026-02-15T13:08:40Z): All code must have tests
+
+---
+
+## 📊 Evolution Log
+
+Track how wisdom has evolved over time.
+
+| Date | Colony | Change | Details |
+|------|--------|--------|---------|
+| 2026-02-15T13:08:40Z | colony-e | promoted_decree | Added: All code must have tests... |
+| 2026-02-15T13:08:36Z | colony-d | promoted_stack | Added: Use jq for JSON in bash... |
+| 2026-02-15T13:08:31Z | colony-c | promoted_redirect | Added: Never skip security checks... |
+| 2026-02-15T13:08:28Z | colony-b | promoted_pattern | Added: Always validate inputs... |
+| 2026-02-15T13:08:24Z | colony-a | promoted_philosophy | Added: Test-driven development ensures quality... |
+| 2026-02-15T13:08:15Z | system | initialized | QUEEN.md created from template |
+
+---
+
+<!-- METADATA
+{
+  "version": "1.0.0",
+  "last_evolved": "2026-02-15T13:08:40Z",
+  "colonies_contributed": ["colony-a"],
+  "promotion_thresholds": {
+    "philosophy": 5,
+    "pattern": 3,
+    "redirect": 2,
+    "stack": 1,
+    "decree": 0
+  },
+  "stats": {
+    "total_philosophies": 1,
+    "total_patterns": 0,
+    "total_redirects": 1,
+    "total_stack_entries": 1,
+    "total_decrees": 1
+  }
+}
+-->