aether-colony 3.1.5 → 3.1.16

package/bin/sync-to-runtime.sh

@@ -0,0 +1,138 @@
+#!/bin/bash
+# sync-to-runtime.sh — Copies allowlisted system files from .aether/ to runtime/
+#
+# Purpose: In the Aether repo, .aether/ is the source of truth for system files.
+#          This script syncs those files INTO runtime/ (the npm staging directory)
+#          so that `npm install -g .` packages the latest versions.
+#
+# Usage: bash bin/sync-to-runtime.sh [--reverse]
+#   --reverse  Copy FROM runtime/ TO .aether/ (one-time seed operation)
+#
+# This script is safe to run multiple times (idempotent).
+# It only copies allowlisted files — it never deletes extras in runtime/.
+
+set -e
+
+# Resolve repo root (one level up from bin/)
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+AETHER_DIR="$REPO_ROOT/.aether"
+RUNTIME_DIR="$REPO_ROOT/runtime"
+
+# Allowlist: these are the system files that sync between .aether/ and runtime/
+# Must match the SYSTEM_FILES array in bin/lib/update-transaction.js
+SYSTEM_FILES=(
+  "aether-utils.sh"
+  "coding-standards.md"
+  "debugging.md"
+  "DISCIPLINES.md"
+  "learning.md"
+  "planning.md"
+  "QUEEN_ANT_ARCHITECTURE.md"
+  "tdd.md"
+  "verification-loop.md"
+  "verification.md"
+  "workers.md"
+  "workers-new-castes.md"
+  "CONTEXT.md"
+  "model-profiles.yaml"
+  "recover.sh"
+  "docs/biological-reference.md"
+  "docs/command-sync.md"
+  "docs/constraints.md"
+  "docs/namespace.md"
+  "docs/pathogen-schema-example.json"
+  "docs/pathogen-schema.md"
+  "docs/PHEROMONE-INJECTION.md"
+  "docs/PHEROMONE-INTEGRATION.md"
+  "docs/PHEROMONE-SYSTEM-DESIGN.md"
+  "docs/pheromones.md"
+  "docs/progressive-disclosure.md"
+  "docs/README.md"
+  "docs/VISUAL-OUTPUT-SPEC.md"
+  "docs/known-issues.md"
+  "docs/implementation-learnings.md"
+  "docs/codebase-review.md"
+  "docs/planning-discipline.md"
+  "utils/atomic-write.sh"
+  "utils/chamber-compare.sh"
+  "utils/chamber-utils.sh"
+  "utils/colorize-log.sh"
+  "utils/error-handler.sh"
+  "utils/file-lock.sh"
+  "utils/spawn-tree.sh"
+  "utils/spawn-with-model.sh"
+  "utils/state-loader.sh"
+  "utils/swarm-display.sh"
+  "utils/watch-spawn-tree.sh"
+  "utils/xml-utils.sh"
+  "utils/xml-core.sh"
+  "utils/xml-compose.sh"
+  "utils/queen-to-md.xsl"
+  "exchange/pheromone-xml.sh"
+  "exchange/wisdom-xml.sh"
+  "exchange/registry-xml.sh"
+  "schemas/aether-types.xsd"
+  "schemas/pheromone.xsd"
+  "schemas/queen-wisdom.xsd"
+  "schemas/colony-registry.xsd"
+  "schemas/worker-priming.xsd"
+  "schemas/prompt.xsd"
+  "templates/QUEEN.md.template"
+)
+
+# Determine direction
+REVERSE=false
+if [ "${1:-}" = "--reverse" ]; then
+  REVERSE=true
+fi
+
+if [ "$REVERSE" = true ]; then
+  SRC_DIR="$RUNTIME_DIR"
+  DST_DIR="$AETHER_DIR"
+  LABEL="runtime/ -> .aether/ (seeding)"
+else
+  SRC_DIR="$AETHER_DIR"
+  DST_DIR="$RUNTIME_DIR"
+  LABEL=".aether/ -> runtime/ (staging)"
+fi
+
+# Check source directory exists
+if [ ! -d "$SRC_DIR" ]; then
+  # Silently exit if source doesn't exist (e.g. installed from npm, no .aether/)
+  exit 0
+fi
+
+copied=0
+skipped=0
+
+for file in "${SYSTEM_FILES[@]}"; do
+  src="$SRC_DIR/$file"
+  dst="$DST_DIR/$file"
+
+  # Skip if source file doesn't exist
+  if [ ! -f "$src" ]; then
+    continue
+  fi
+
+  # Create destination directory if needed
+  dst_dir="$(dirname "$dst")"
+  mkdir -p "$dst_dir"
+
+  # Skip if files are identical (compare hashes)
+  if [ -f "$dst" ]; then
+    src_hash=$(shasum -a 256 "$src" 2>/dev/null | cut -d' ' -f1)
+    dst_hash=$(shasum -a 256 "$dst" 2>/dev/null | cut -d' ' -f1)
+    if [ "$src_hash" = "$dst_hash" ]; then
+      skipped=$((skipped + 1))
+      continue
+    fi
+  fi
+
+  cp "$src" "$dst"
+  copied=$((copied + 1))
+done
+
+# Only print output if not running in quiet mode (npm postinstall suppresses)
+if [ -t 1 ] || [ "${VERBOSE:-}" = "1" ]; then
+  echo "Sync ($LABEL): $copied copied, $skipped unchanged"
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-colony",
-  "version": "3.1.5",
+  "version": "3.1.16",
   "description": "Multi-agent system using ant colony intelligence for Claude Code and OpenCode — workers self-organize via pheromone signals",
   "bin": {
     "aether": "bin/cli.js"
@@ -12,13 +12,13 @@
     ".opencode/agents/",
     ".opencode/opencode.json",
     "runtime/",
-    ".aether/visualizations/",
     "README.md",
     "LICENSE",
     "DISCLAIMER.md",
     "CHANGELOG.md"
   ],
   "scripts": {
+    "preinstall": "bash bin/sync-to-runtime.sh 2>/dev/null || true",
     "postinstall": "node bin/cli.js install --quiet",
     "test": "npm run test:unit && npm run test:bash",
     "test:unit": "ava",

package/runtime/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 — `runtime/` is auto-populated on publish | 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
+
+---
+