aether-colony 3.1.17 → 5.0.0

package/bin/lib/update-transaction.js

@@ -161,62 +161,21 @@ class UpdateTransaction {
     // Hub paths (from cli.js)
     this.HOME = process.env.HOME || process.env.USERPROFILE;
     this.HUB_DIR = path.join(this.HOME, '.aether');
-    this.HUB_COMMANDS_CLAUDE = path.join(this.HUB_DIR, 'commands', 'claude');
-    this.HUB_COMMANDS_OPENCODE = path.join(this.HUB_DIR, 'commands', 'opencode');
-    this.HUB_AGENTS = path.join(this.HUB_DIR, 'agents');
+    this.HUB_SYSTEM_DIR = path.join(this.HUB_DIR, 'system');
+    this.HUB_COMMANDS_CLAUDE = path.join(this.HUB_SYSTEM_DIR, 'commands', 'claude');
+    this.HUB_COMMANDS_OPENCODE = path.join(this.HUB_SYSTEM_DIR, 'commands', 'opencode');
+    this.HUB_AGENTS = path.join(this.HUB_SYSTEM_DIR, 'agents');
+    this.HUB_AGENTS_CLAUDE = path.join(this.HUB_SYSTEM_DIR, 'agents-claude');
+    this.HUB_RULES = path.join(this.HUB_SYSTEM_DIR, 'rules');
     this.HUB_VERSION = path.join(this.HUB_DIR, 'version.json');
     this.HUB_REGISTRY = path.join(this.HUB_DIR, 'registry.json');
 
-    // Directories to exclude from sync (user data, local state)
-    this.EXCLUDE_DIRS = ['data', 'dreams', 'checkpoints', 'locks', 'temp'];
+    // Directories to exclude from sync (user data, local state, and separately-synced dirs)
+    // v4.0: archive and chambers added — these are private and must not sync to target repos
+    this.EXCLUDE_DIRS = ['data', 'dreams', 'checkpoints', 'locks', 'temp', 'agents', 'commands', 'rules', 'archive', 'chambers'];
 
     // Target directories for git safety checks
-    this.targetDirs = ['.aether', '.claude/commands/ant', '.opencode/commands/ant', '.opencode/agents'];
-
-    // System files allowlist (from cli.js)
-    this.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',
-      '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',
-      'templates/QUEEN.md.template',
-    ];
+    this.targetDirs = ['.aether', '.claude/commands/ant', '.claude/agents/ant', '.claude/rules', '.opencode/commands/ant', '.opencode/agents'];
   }
 
   /**
@@ -686,66 +645,6 @@ class UpdateTransaction {
     }
   }
 
-  /**
-   * Sync system files from hub
-   * @param {string} srcDir - Source directory
-   * @param {string} destDir - Destination directory
-   * @param {object} opts - Options
-   * @returns {object} Sync result: { copied, removed, skipped }
-   * @private
-   */
-  syncSystemFilesWithCleanup(srcDir, destDir, opts) {
-    opts = opts || {};
-    const dryRun = opts.dryRun || false;
-
-    let copied = 0;
-    let skipped = 0;
-
-    for (const file of this.SYSTEM_FILES) {
-      const srcPath = path.join(srcDir, file);
-      const destPath = path.join(destDir, file);
-      if (fs.existsSync(srcPath)) {
-        if (!dryRun) {
-          // Compute hashes to determine if copy is needed
-          const srcHash = this.hashFileSync(srcPath);
-          const destHash = fs.existsSync(destPath) ? this.hashFileSync(destPath) : null;
-
-          if (srcHash === destHash) {
-            // Files are identical, skip copying
-            skipped++;
-            continue;
-          }
-
-          fs.mkdirSync(path.dirname(destPath), { recursive: true });
-          fs.copyFileSync(srcPath, destPath);
-          if (file.endsWith('.sh')) {
-            fs.chmodSync(destPath, 0o755);
-          }
-        }
-        copied++;
-      }
-    }
-
-    // Remove allowlisted files that no longer exist in src
-    const removed = [];
-    for (const file of this.SYSTEM_FILES) {
-      const srcPath = path.join(srcDir, file);
-      const destPath = path.join(destDir, file);
-      if (!fs.existsSync(srcPath) && fs.existsSync(destPath)) {
-        removed.push(file);
-        if (!dryRun) {
-          fs.unlinkSync(destPath);
-        }
-      }
-    }
-
-    if (!dryRun && removed.length > 0) {
-      this.cleanEmptyDirs(destDir);
-    }
-
-    return { copied, removed, skipped };
-  }
-
   /**
    * Check if a path should be excluded from sync
    * @param {string} relPath - Relative path
@@ -867,6 +766,60 @@ class UpdateTransaction {
     return { copied, removed, skipped };
   }
 
+  /**
+   * Remove known stale directories and files left behind by pre-3.0.0 versions.
+   * These paths were incorrectly distributed in earlier releases and must be
+   * explicitly removed — EXCLUDE_DIRS prevents NEW pollution but does not clean
+   * items that already exist on disk.
+   *
+   * Idempotent: safe to call when items do not exist.
+   *
+   * @param {string} repoPath - Absolute path to the target repository root
+   * @returns {{ cleaned: string[], failed: Array<{label: string, error: string}> }}
+   */
+  cleanupStaleAetherDirs(repoPath) {
+    const staleItems = [
+      {
+        path: path.join(repoPath, '.aether', 'agents'),
+        label: '.aether/agents/ (stale duplicate)',
+        type: 'dir',
+      },
+      {
+        path: path.join(repoPath, '.aether', 'commands'),
+        label: '.aether/commands/ (stale duplicate)',
+        type: 'dir',
+      },
+      {
+        path: path.join(repoPath, '.aether', 'planning.md'),
+        label: '.aether/planning.md (phantom file)',
+        type: 'file',
+      },
+    ];
+
+    const cleaned = [];
+    const failed = [];
+
+    for (const item of staleItems) {
+      if (!fs.existsSync(item.path)) {
+        // Already clean — idempotent skip
+        continue;
+      }
+
+      try {
+        if (item.type === 'dir') {
+          fs.rmSync(item.path, { recursive: true, force: true });
+        } else {
+          fs.unlinkSync(item.path);
+        }
+        cleaned.push(item.label);
+      } catch (err) {
+        failed.push({ label: item.label, error: err.message });
+      }
+    }
+
+    return { cleaned, failed };
+  }
+
   /**
    * Sync files from hub to repo
    * @param {string} sourceVersion - Version to sync from
@@ -880,14 +833,16 @@ class UpdateTransaction {
       system: { copied: 0, removed: 0, skipped: 0 },
       commands: { copied: 0, removed: 0, skipped: 0 },
       agents: { copied: 0, removed: 0, skipped: 0 },
+      agents_claude: { copied: 0, removed: [], skipped: 0 },
+      rules: { copied: 0, removed: 0, skipped: 0 },
       errors: [],
     };
 
     const repoAether = path.join(this.repoPath, '.aether');
 
     // Sync .aether/ from hub to repo (excluding user data directories)
-    if (fs.existsSync(this.HUB_DIR)) {
-      results.system = this.syncAetherToRepo(this.HUB_DIR, repoAether, { dryRun });
+    if (fs.existsSync(this.HUB_SYSTEM_DIR)) {
+      results.system = this.syncAetherToRepo(this.HUB_SYSTEM_DIR, repoAether, { dryRun });
     }
 
     // Sync commands from hub
@@ -911,6 +866,18 @@ class UpdateTransaction {
       results.agents = this.syncDirWithCleanup(this.HUB_AGENTS, repoAgents, { dryRun });
     }
 
+    // Sync claude agents from hub to .claude/agents/ant/
+    const repoClaudeAgents = path.join(this.repoPath, '.claude', 'agents', 'ant');
+    if (fs.existsSync(this.HUB_AGENTS_CLAUDE)) {
+      results.agents_claude = this.syncDirWithCleanup(this.HUB_AGENTS_CLAUDE, repoClaudeAgents, { dryRun });
+    }
+
+    // Sync rules from hub to .claude/rules/
+    const repoRules = path.join(this.repoPath, '.claude', 'rules');
+    if (fs.existsSync(this.HUB_RULES)) {
+      results.rules = this.syncDirWithCleanup(this.HUB_RULES, repoRules, { dryRun });
+    }
+
     this.syncResult = results;
     return results;
   }
@@ -953,10 +920,12 @@ class UpdateTransaction {
     };
 
     const repoAether = path.join(this.repoPath, '.aether');
-    verifyDir(this.HUB_DIR, repoAether);
+    verifyDir(this.HUB_SYSTEM_DIR, repoAether);
     verifyDir(this.HUB_COMMANDS_CLAUDE, path.join(this.repoPath, '.claude', 'commands', 'ant'));
     verifyDir(this.HUB_COMMANDS_OPENCODE, path.join(this.repoPath, '.opencode', 'commands', 'ant'));
     verifyDir(this.HUB_AGENTS, path.join(this.repoPath, '.opencode', 'agents'));
+    verifyDir(this.HUB_AGENTS_CLAUDE, path.join(this.repoPath, '.claude', 'agents', 'ant'));
+    verifyDir(this.HUB_RULES, path.join(this.repoPath, '.claude', 'rules'));
 
     return {
       valid: errors.length === 0,
@@ -1002,6 +971,8 @@ class UpdateTransaction {
     checkDir(this.HUB_COMMANDS_CLAUDE, 'commands/claude');
     checkDir(this.HUB_COMMANDS_OPENCODE, 'commands/opencode');
     checkDir(this.HUB_AGENTS, 'agents');
+    checkDir(this.HUB_AGENTS_CLAUDE, 'agents-claude');
+    checkDir(this.HUB_RULES, 'rules');
     checkDir(this.HUB_VERSION, 'version');
 
     // Check if source files exist
@@ -1098,10 +1069,11 @@ class UpdateTransaction {
     };
 
     const repoAether = path.join(this.repoPath, '.aether');
-    checkDir(this.HUB_DIR, repoAether);
+    checkDir(this.HUB_SYSTEM_DIR, repoAether);
     checkDir(this.HUB_COMMANDS_CLAUDE, path.join(this.repoPath, '.claude', 'commands', 'ant'));
     checkDir(this.HUB_COMMANDS_OPENCODE, path.join(this.repoPath, '.opencode', 'commands', 'ant'));
     checkDir(this.HUB_AGENTS, path.join(this.repoPath, '.opencode', 'agents'));
+    checkDir(this.HUB_RULES, path.join(this.repoPath, '.claude', 'rules'));
 
     return {
       isPartial: missing.length > 0 || corrupted.length > 0,
@@ -1260,6 +1232,14 @@ class UpdateTransaction {
    * @returns {Promise<boolean>} True if rollback succeeded
    */
   async rollback() {
+    // Clear pending sentinel on rollback — we've cleanly returned to prior state
+    const pendingPath = path.join(this.repoPath, '.aether', '.update-pending');
+    try {
+      if (fs.existsSync(pendingPath)) {
+        fs.unlinkSync(pendingPath);
+      }
+    } catch { /* ignore — rollback cleanup is best-effort */ }
+
     this.state = TransactionStates.ROLLING_BACK;
     this.log('  Rolling back to checkpoint...');
 
@@ -1342,6 +1322,13 @@ class UpdateTransaction {
   async execute(sourceVersion, options = {}) {
     const dryRun = options.dryRun || false;
 
+    // Write pending sentinel BEFORE any work — marks update as in-flight
+    const pendingPath = path.join(this.repoPath, '.aether', '.update-pending');
+    this.writeJsonSync(pendingPath, {
+      target_version: sourceVersion,
+      started_at: new Date().toISOString(),
+    });
+
     try {
       // Phase 0: Validate repo state (before any modifications)
       // Check for dirty repo and provide clear recovery instructions
@@ -1368,6 +1355,9 @@ class UpdateTransaction {
 
       await this.createCheckpoint();
 
+      // Clean up known stale directories/files from previous versions
+      this.cleanupResult = this.cleanupStaleAetherDirs(this.repoPath);
+
       // Phase 2: Sync (with network error handling)
       this.state = TransactionStates.SYNCING;
       try {
@@ -1403,15 +1393,26 @@ class UpdateTransaction {
         this.state = TransactionStates.COMMITTING;
         this.updateVersion(sourceVersion);
         this.state = TransactionStates.COMMITTED;
+
+        // Delete pending sentinel — update is now complete
+        try {
+          if (fs.existsSync(pendingPath)) {
+            fs.unlinkSync(pendingPath);
+          }
+        } catch (err) {
+          this.log(`  Warning: could not clear update sentinel: ${err.message}`);
+        }
       }
 
       // Calculate totals
       const filesSynced = (this.syncResult?.system?.copied || 0) +
                          (this.syncResult?.commands?.copied || 0) +
-                         (this.syncResult?.agents?.copied || 0);
+                         (this.syncResult?.agents?.copied || 0) +
+                         (this.syncResult?.rules?.copied || 0);
       const filesRemoved = (this.syncResult?.system?.removed?.length || 0) +
                           (this.syncResult?.commands?.removed?.length || 0) +
-                          (this.syncResult?.agents?.removed?.length || 0);
+                          (this.syncResult?.agents?.removed?.length || 0) +
+                          (this.syncResult?.rules?.removed?.length || 0);
 
       return {
         success: true,
@@ -1420,6 +1421,7 @@ class UpdateTransaction {
         files_synced: filesSynced,
         files_removed: filesRemoved,
         sync_result: this.syncResult,
+        cleanup_result: this.cleanupResult || { cleaned: [], failed: [] },
       };
 
     } catch (error) {

package/bin/sync-to-runtime.sh

@@ -1,138 +1,6 @@
 #!/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
+# sync-to-runtime.sh — DEPRECATED (v4.0)
+# runtime/ staging was eliminated in v4.0. .aether/ is packaged directly.
+# This script exists only for CI backward compatibility.
+echo "runtime/ sync skipped — deprecated in v4.0 (direct .aether/ packaging)"
+exit 0

package/bin/validate-package.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# validate-package.sh — Pre-packaging validation for aether-colony npm package
+#
+# Purpose: Replaces sync-to-runtime.sh (removed in v4.0). Instead of copying files
+#          to a staging directory, this script validates that .aether/ is ready for
+#          direct packaging: required files exist, private directories are excluded.
+#
+# Usage: bash bin/validate-package.sh [--dry-run]
+#   --dry-run  Run npm pack --dry-run to show what would be published
+#
+# This script is safe to run multiple times (idempotent).
+
+set -euo pipefail
+
+# Resolve paths relative to script location
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+AETHER_DIR="$(cd "$SCRIPT_DIR/../.aether" && pwd)"
+
+# --dry-run mode: delegate to npm pack and exit
+if [ "${1:-}" = "--dry-run" ]; then
+  cd "$REPO_ROOT"
+  npm pack --dry-run 2>&1
+  exit 0
+fi
+
+# Required files that must exist in .aether/ before packaging
+REQUIRED_FILES=(
+  "aether-utils.sh"
+  "workers.md"
+  "CONTEXT.md"
+  "model-profiles.yaml"
+  "docs/README.md"
+  "utils/atomic-write.sh"
+  "utils/error-handler.sh"
+  "utils/file-lock.sh"
+  "templates/QUEEN.md.template"
+  "templates/colony-state.template.json"
+  "templates/constraints.template.json"
+  "templates/colony-state-reset.jq.template"
+  "templates/crowned-anthill.template.md"
+  "templates/handoff.template.md"
+  "templates/handoff-build-error.template.md"
+  "templates/handoff-build-success.template.md"
+  "rules/aether-colony.md"
+)
+
+# Verify required files exist
+for file in "${REQUIRED_FILES[@]}"; do
+  if [ ! -f "$AETHER_DIR/$file" ]; then
+    echo "ERROR: Required file missing from .aether/: $file" >&2
+    echo "  Run this from the Aether repo root after editing .aether/ files." >&2
+    exit 1
+  fi
+done
+
+# Private directories that must never be published
+PRIVATE_DIRS=(
+  "data"
+  "dreams"
+  "oracle"
+  "checkpoints"
+  "locks"
+  "temp"
+  "archive"
+  "chambers"
+)
+
+# .aether/.npmignore is the effective ignore file for the .aether/ subdirectory.
+# npm-packlist reads subdirectory .npmignore files when walking included directories.
+AETHER_NPMIGNORE="$AETHER_DIR/.npmignore"
+
+# Verify each private directory is excluded in .aether/.npmignore (hard block)
+for dir in "${PRIVATE_DIRS[@]}"; do
+  if [ -d "$AETHER_DIR/$dir" ]; then
+    if ! grep -qF "$dir/" "$AETHER_NPMIGNORE" 2>/dev/null; then
+      echo "ERROR: Private directory .aether/$dir/ exists but is NOT excluded in .aether/.npmignore" >&2
+      echo "  Add '$dir/' to .aether/.npmignore to prevent publishing private data." >&2
+      exit 1
+    fi
+  fi
+done
+
+echo "Package validation passed."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-colony",
-  "version": "3.1.17",
+  "version": "5.0.0",
   "description": "Multi-agent system using ant colony intelligence for Claude Code and OpenCode — workers self-organize via pheromone signals",
   "bin": {
     "aether": "bin/cli.js"
@@ -8,23 +8,26 @@
   "files": [
     "bin/",
     ".claude/commands/ant/",
+    ".claude/agents/ant/",
     ".opencode/commands/ant/",
     ".opencode/agents/",
     ".opencode/opencode.json",
-    "runtime/",
+    ".aether/",
     "README.md",
     "LICENSE",
     "DISCLAIMER.md",
     "CHANGELOG.md"
   ],
   "scripts": {
-    "preinstall": "bash bin/sync-to-runtime.sh 2>/dev/null || true",
+    "preinstall": "bash bin/validate-package.sh 2>/dev/null || true",
     "postinstall": "node bin/cli.js install --quiet",
-    "test": "npm run test:unit && npm run test:bash",
+    "prepublishOnly": "bash bin/validate-package.sh",
+    "test": "npm run test:unit",
+    "test:all": "npm run test:unit && npm run test:bash",
     "test:unit": "ava",
     "test:bash": "bash tests/bash/test-aether-utils.sh",
-    "lint:shell": "shellcheck --severity=error .aether/aether-utils.sh runtime/aether-utils.sh bin/generate-commands.sh .aether/utils/file-lock.sh .aether/utils/atomic-write.sh .aether/utils/colorize-log.sh .aether/utils/watch-spawn-tree.sh runtime/utils/file-lock.sh runtime/utils/atomic-write.sh runtime/utils/colorize-log.sh runtime/utils/watch-spawn-tree.sh",
-    "lint:json": "node -e \"const fs=require('fs'); const files=['.aether/data/constraints.json','.aether/data/COLONY_STATE.json']; files.forEach(f=>{JSON.parse(fs.readFileSync(f,'utf8'))}); console.log('JSON valid')\"",
+    "lint:shell": "shellcheck --severity=error .aether/aether-utils.sh bin/generate-commands.sh .aether/utils/file-lock.sh .aether/utils/atomic-write.sh .aether/utils/colorize-log.sh .aether/utils/watch-spawn-tree.sh",
+    "lint:json": "node -e \"const fs=require('fs'); const files=['.aether/data/constraints.json','.aether/data/COLONY_STATE.json']; files.filter(f=>fs.existsSync(f)).forEach(f=>{JSON.parse(fs.readFileSync(f,'utf8'))}); console.log('JSON valid')\"",
     "lint:sync": "bash bin/generate-commands.sh check",
     "lint": "npm run lint:shell && npm run lint:json && npm run lint:sync"
   },

package/.opencode/agents/aether-architect.md

@@ -1,66 +0,0 @@
----
-name: aether-architect
-description: "Architect ant - synthesizes knowledge and coordinates documentation"
----
-
-You are an **Architect Ant** in the Aether Colony. You are the colony's wisdom — when the colony learns, you organize and preserve that knowledge.
-
-## Aether Integration
-
-This agent operates as a **specialist worker** within the Aether Colony system. You:
-- Report to the Queen/Prime worker who spawns you
-- Log activity using Aether utilities
-- Follow depth-based spawning rules
-- Output structured JSON reports
-
-## Activity Logging
-
-Log progress as you work:
-```bash
-bash .aether/aether-utils.sh activity-log "ACTION" "{your_name} (Architect)" "description"
-```
-
-Actions: SYNTHESIZING, EXTRACTING, ORGANIZING, COMPLETED
-
-## Your Role
-
-As Architect, you:
-1. Analyze input — what knowledge needs organizing?
-2. Extract patterns — success patterns, failure patterns, preferences
-3. Synthesize into coherent structures
-4. Document clear, actionable summaries with recommendations
-
-## Synthesis Workflow
-
-1. **Gather** - Collect all relevant information
-2. **Analyze** - Identify patterns and themes
-3. **Structure** - Organize into logical hierarchy
-4. **Document** - Create clear, actionable output
-
-## Model Context
-
-- **Model:** glm-5
-- **Strengths:** Long-context synthesis, pattern extraction, complex documentation
-- **Best for:** Synthesizing knowledge, coordinating docs, pattern recognition
-
-## Output Format
-
-```json
-{
-  "ant_name": "{your name}",
-  "caste": "architect",
-  "target": "{what was synthesized}",
-  "status": "completed",
-  "patterns_extracted": [],
-  "synthesis": {
-    "summary": "{overall summary}",
-    "key_findings": [],
-    "recommendations": []
-  },
-  "documentation": {}
-}
-```
-
-## Reference
-
-Full worker specifications: `.aether/workers.md`