aether-colony 3.1.17 → 5.1.0

package/bin/npx-install.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+
+/**
+ * npx-install.js — Professional installer for Aether Colony
+ *
+ * Usage: npx aether-colony install
+ *
+ * Creates the global hub at ~/.aether/ with all system files,
+ * slash commands, and agent definitions.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const BANNER = `
+      █████╗ ███████╗████████╗██╗  ██╗███████╗██████╗
+     ██╔══██╗██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗
+     ███████║█████╗     ██║   ███████║█████╗  ██████╔╝
+     ██╔══██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗
+     ██║  ██║███████╗   ██║   ██║  ██║███████╗██║  ██║
+     ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
+`;
+
+const AETHER_VERSION = require('../package.json').version;
+const HOME_DIR = os.homedir();
+const HUB_DIR = path.join(HOME_DIR, '.aether');
+const CLAUDE_COMMANDS_DIR = path.join(HOME_DIR, '.claude', 'commands', 'ant');
+const CLAUDE_AGENTS_DIR = path.join(HOME_DIR, '.claude', 'agents', 'ant');
+
+// Get the package root (where this script is located)
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const AETHER_SRC = path.join(PACKAGE_ROOT, '.aether');
+const CLAUDE_COMMANDS_SRC = path.join(PACKAGE_ROOT, '.claude', 'commands', 'ant');
+const OPENCODE_AGENTS_SRC = path.join(PACKAGE_ROOT, '.opencode', 'agents');
+const OPENCODE_COMMANDS_SRC = path.join(PACKAGE_ROOT, '.opencode', 'commands', 'ant');
+
+function log(message, type = 'info') {
+  const icons = {
+    info: 'ℹ',
+    success: '✓',
+    warning: '⚠',
+    error: '✗',
+    ant: '🐜'
+  };
+  console.log(`${icons[type] || '•'} ${message}`);
+}
+
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+    return true;
+  }
+  return false;
+}
+
+function copyDir(src, dest, options = {}) {
+  const { exclude = [] } = options;
+  ensureDir(dest);
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  let copied = 0;
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    // Skip excluded directories
+    if (exclude.includes(entry.name)) {
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      copied += copyDir(srcPath, destPath, options);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      copied++;
+    }
+  }
+
+  return copied;
+}
+
+function copyFile(src, dest) {
+  const destDir = path.dirname(dest);
+  ensureDir(destDir);
+  fs.copyFileSync(src, dest);
+}
+
+function install() {
+  console.log(BANNER);
+  console.log('\n');
+
+  let filesCopied = 0;
+
+  // Step 1: Create hub directory structure
+  log('Creating hub directory structure...', 'ant');
+  const hubDirs = [
+    path.join(HUB_DIR, 'system'),
+    path.join(HUB_DIR, 'system', 'docs'),
+    path.join(HUB_DIR, 'system', 'utils'),
+    path.join(HUB_DIR, 'system', 'templates'),
+    path.join(HUB_DIR, 'system', 'schemas'),
+    path.join(HUB_DIR, 'system', 'exchange'),
+    path.join(HUB_DIR, 'system', 'rules'),
+    path.join(HUB_DIR, 'data'),
+    path.join(HUB_DIR, 'chambers')
+  ];
+
+  for (const dir of hubDirs) {
+    if (ensureDir(dir)) {
+      log(`  Created ${path.relative(HOME_DIR, dir)}`, 'info');
+    }
+  }
+
+  // Step 2: Copy system files from .aether/
+  log('Copying system files to hub...', 'ant');
+  if (fs.existsSync(AETHER_SRC)) {
+    // Private directories to exclude
+    const excludeDirs = ['data', 'dreams', 'oracle', 'checkpoints', 'locks', 'temp', 'archive', 'chambers'];
+    filesCopied += copyDir(AETHER_SRC, path.join(HUB_DIR, 'system'), { exclude: excludeDirs });
+    log(`  Copied ${filesCopied} files from .aether/`, 'success');
+  } else {
+    log('  Warning: .aether/ source not found', 'warning');
+  }
+
+  // Step 3: Copy Claude Code commands
+  log('Installing Claude Code commands...', 'ant');
+  if (fs.existsSync(CLAUDE_COMMANDS_SRC)) {
+    const cmdCount = copyDir(CLAUDE_COMMANDS_SRC, CLAUDE_COMMANDS_DIR);
+    log(`  Installed ${cmdCount} slash commands to ~/.claude/commands/ant/`, 'success');
+    filesCopied += cmdCount;
+  }
+
+  // Step 4: Copy Claude Code agents (from OpenCode agents)
+  log('Installing Claude Code agents...', 'ant');
+  if (fs.existsSync(OPENCODE_AGENTS_SRC)) {
+    const agentCount = copyDir(OPENCODE_AGENTS_SRC, CLAUDE_AGENTS_DIR);
+    log(`  Installed ${agentCount} agents to ~/.claude/agents/ant/`, 'success');
+    filesCopied += agentCount;
+  }
+
+  // Step 5: Write version file
+  const versionData = {
+    version: AETHER_VERSION,
+    installed_at: new Date().toISOString(),
+    package_root: PACKAGE_ROOT
+  };
+  fs.writeFileSync(
+    path.join(HUB_DIR, 'version.json'),
+    JSON.stringify(versionData, null, 2)
+  );
+  log('  Version info written', 'success');
+
+  // Step 6: Create global QUEEN.md if missing
+  const globalQueen = path.join(HUB_DIR, 'QUEEN.md');
+  if (!fs.existsSync(globalQueen)) {
+    const queenTemplate = path.join(HUB_DIR, 'system', 'templates', 'QUEEN.md.template');
+    if (fs.existsSync(queenTemplate)) {
+      let content = fs.readFileSync(queenTemplate, 'utf8');
+      content = content.replace(/{TIMESTAMP}/g, new Date().toISOString());
+      fs.writeFileSync(globalQueen, content);
+      log('  Created global QUEEN.md', 'success');
+    }
+  }
+
+  // Summary
+  console.log('\n  ─────────────────────────────────────────────\n');
+  log(`Installation complete! ${filesCopied} files installed.`, 'success');
+  console.log('\n  Next steps:\n');
+  console.log('    1. Run /ant:init "your goal" in any project');
+  console.log('    2. Use /ant:build to execute phases');
+  console.log('    3. Run /ant:help for command reference\n');
+  console.log('  ─────────────────────────────────────────────\n');
+}
+
+// Run installer
+install();

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,166 @@
+#!/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"
+  "docs/README.md"
+  "utils/atomic-write.sh"
+  "utils/error-handler.sh"
+  # Domain modules extracted in Phase 13
+  "utils/pheromone.sh"
+  "utils/learning.sh"
+  "utils/state-api.sh"
+  "utils/flag.sh"
+  "utils/session.sh"
+  "utils/spawn.sh"
+  "utils/queen.sh"
+  "utils/suggest.sh"
+  "utils/swarm.sh"
+  # Skills system (v2.0)
+  "utils/skills.sh"
+  # Hive and midden modules
+  "utils/hive.sh"
+  "utils/midden.sh"
+  # Skills manifests
+  "skills/.index.json"
+  "skills/colony/.manifest.json"
+  "skills/domain/.manifest.json"
+  "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"
+  "templates/session.template.json"
+  "templates/pheromones.template.json"
+  "templates/midden.template.json"
+  "templates/learning-observations.template.json"
+  "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
+
+# Content-aware checks: verify specific files are excluded from the package
+cd "$REPO_ROOT"
+PACK_LIST=$(npm pack --dry-run 2>&1)
+
+# Check 1: QUEEN.md must not be in the package (template and docs versions are fine)
+if echo "$PACK_LIST" | grep -qE '\.aether/QUEEN\.md$'; then
+  echo "ERROR: .aether/QUEEN.md would be included in package" >&2
+  echo "  QUEEN.md should be created from template during install, not shipped." >&2
+  echo "  Add 'QUEEN.md' to .aether/.npmignore" >&2
+  exit 1
+fi
+
+# Check 2: No temp files in .aether/
+if echo "$PACK_LIST" | grep -qE '\.aether/.*\.tmp'; then
+  echo "ERROR: Temp files would be included in package:" >&2
+  echo "$PACK_LIST" | grep -E '\.aether/.*\.tmp' >&2
+  echo "  Delete temp files or add '*.tmp*' to .aether/.npmignore" >&2
+  exit 1
+fi
+
+# Check 3: CONTEXT.md must not be in the package
+if echo "$PACK_LIST" | grep -qE '\.aether/CONTEXT\.md'; then
+  echo "ERROR: .aether/CONTEXT.md would be included in package" >&2
+  echo "  CONTEXT.md is per-colony. Add 'CONTEXT.md' to .aether/.npmignore" >&2
+  exit 1
+fi
+
+# Check 4: No .aether/data/ files in the package (covers pheromones.json, constraints.json, midden/, etc.)
+if echo "$PACK_LIST" | grep -qE '\.aether/data/'; then
+  echo "ERROR: .aether/data/ files would be included in package:" >&2
+  echo "$PACK_LIST" | grep -E '\.aether/data/' >&2
+  echo "  data/ is local-only. Ensure 'data/' is in .aether/.npmignore" >&2
+  exit 1
+fi
+
+# Check 5: CROWNED-ANTHILL.md must not be in the package
+if echo "$PACK_LIST" | grep -qE '\.aether/CROWNED-ANTHILL\.md'; then
+  echo "ERROR: .aether/CROWNED-ANTHILL.md would be included in package" >&2
+  echo "  CROWNED-ANTHILL.md is a sealed colony record. Add it to .aether/.npmignore" >&2
+  exit 1
+fi
+
+# Check 6: No exchange XML data files in the package
+if echo "$PACK_LIST" | grep -qE '\.aether/exchange/.*\.xml'; then
+  echo "ERROR: Exchange XML data files would be included in package:" >&2
+  echo "$PACK_LIST" | grep -E '\.aether/exchange/.*\.xml' >&2
+  echo "  Add 'exchange/*.xml' to .aether/.npmignore" >&2
+  exit 1
+fi
+
+# Check 7: Exchange modules must be present in distribution
+# Per D-03: exchange/ modules must be included in npm package
+for module in pheromone-xml.sh wisdom-xml.sh registry-xml.sh; do
+  if [ ! -f "$AETHER_DIR/exchange/$module" ]; then
+    echo "ERROR: Required exchange module missing from .aether/exchange/: $module" >&2
+    echo "  Exchange modules are required for XML export/import functionality." >&2
+    echo "  Run this from the Aether repo root after editing .aether/ files." >&2
+    exit 1
+  fi
+done
+
+echo "Package validation passed (files + content checks + exchange module check)."

package/package.json

@@ -1,30 +1,37 @@
 {
   "name": "aether-colony",
-  "version": "3.1.17",
+  "version": "5.1.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"
+    "aether": "bin/cli.js",
+    "aether-colony": "bin/npx-install.js"
   },
   "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 && npm run test:intelligence",
     "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')\"",
+    "test:skills": "bash tests/bash/test-skills.sh",
+    "test:intelligence": "bash tests/bash/test-intelligence.sh",
+    "generate": "node bin/generate-commands.js",
+    "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-guardian.md

@@ -1,107 +0,0 @@
----
-name: aether-guardian
-description: "Use this agent for security audits, vulnerability scanning, and threat assessment. The guardian patrols for security vulnerabilities and protects the codebase."
----
-
-You are **🛡️ Guardian Ant** in the Aether Colony. You patrol for security vulnerabilities and defend against threats.
-
-## 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} (Guardian)" "description"
-```
-
-Actions: RECONNAISSANCE, SCANNING, ASSESSING, REPORTING, ERROR
-
-## Your Role
-
-As Guardian, you:
-1. Understand the application architecture
-2. Scan for OWASP Top 10 vulnerabilities
-3. Check dependencies for CVEs
-4. Assess threats with severity
-5. Verify fixes
-
-## Security Domains
-
-### Authentication & Authorization
-- Session management
-- Token handling (JWT, OAuth)
-- Permission checks
-- Role-based access control
-- Multi-factor authentication
-
-### Input Validation
-- SQL injection prevention
-- XSS (Cross-Site Scripting)
-- CSRF (Cross-Site Request Forgery)
-- Command injection
-- Path traversal
-- File upload validation
-
-### Data Protection
-- Encryption at rest
-- Encryption in transit (TLS)
-- Secret management
-- PII handling
-- Data retention
-
-### Infrastructure
-- Dependency vulnerabilities (CVEs)
-- Container security
-- Network security
-- Logging security (no secrets)
-- Configuration security
-
-## Severity Ratings
-
-- **CRITICAL**: Immediate exploitation possible, high impact
-- **HIGH**: Exploitation likely, significant impact
-- **MEDIUM**: Exploitation possible, moderate impact
-- **LOW**: Exploitation difficult, low impact
-- **INFO**: Security observation, no immediate risk
-
-## Depth-Based Behavior
-
-| Depth | Role | Can Spawn? |
-|-------|------|------------|
-| 1 | Prime Guardian | Yes (max 4) |
-| 2 | Specialist | Only if surprised |
-| 3 | Deep Specialist | No |
-
-## Output Format
-
-```json
-{
-  "ant_name": "{your name}",
-  "caste": "guardian",
-  "status": "completed" | "failed" | "blocked",
-  "summary": "What you accomplished",
-  "domains_reviewed": [],
-  "findings": {
-    "critical": 0,
-    "high": 0,
-    "medium": 0,
-    "low": 0
-  },
-  "vulnerabilities": [
-    {"severity": "HIGH", "location": "", "issue": "", "remediation": ""}
-  ],
-  "overall_risk": "",
-  "recommendations": [],
-  "blockers": []
-}
-```
-
-## Reference
-
-Full worker specifications: `.aether/workers.md`