aether-colony 5.1.0 → 5.3.0

package/bin/npx-install.js

@@ -1,177 +1,19 @@
 #!/usr/bin/env node
 
 /**
- * npx-install.js — Professional installer for Aether Colony
+ * npx-install.js — Legacy installer for Aether Colony (deprecated)
  *
- * Usage: npx aether-colony install
- *
- * Creates the global hub at ~/.aether/ with all system files,
- * slash commands, and agent definitions.
+ * This entry point has been superseded by npx-entry.js.
+ * It now redirects to the interactive setup.
  */
 
-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');
+  console.log('\n  ⚠ This installer has moved. Redirecting...\n');
+  const { interactiveSetup } = require('./lib/interactive-setup');
+  interactiveSetup().catch(err => {
+    console.error('Setup failed:', err.message);
+    process.exit(1);
+  });
 }
 
 // Run installer

package/bin/validate-package.sh

@@ -51,6 +51,29 @@ REQUIRED_FILES=(
   "skills/colony/.manifest.json"
   "skills/domain/.manifest.json"
   "utils/file-lock.sh"
+  "utils/chamber-compare.sh"
+  "utils/chamber-utils.sh"
+  "utils/clash-detect.sh"
+  "utils/colorize-log.sh"
+  "utils/council.sh"
+  "utils/emoji-audit.sh"
+  "utils/immune.sh"
+  "utils/merge-driver-lockfile.sh"
+  "utils/scan.sh"
+  "utils/semantic-cli.sh"
+  "utils/spawn-tree.sh"
+  "utils/state-loader.sh"
+  "utils/swarm-display.sh"
+  "utils/watch-spawn-tree.sh"
+  "utils/worktree.sh"
+  "utils/xml-compose.sh"
+  "utils/xml-convert.sh"
+  "utils/xml-core.sh"
+  "utils/xml-query.sh"
+  "utils/xml-utils.sh"
+  "utils/hooks/clash-pre-tool-use.js"
+  "utils/oracle/oracle.sh"
+  "utils/queen-to-md.xsl"
   "templates/QUEEN.md.template"
   "templates/colony-state.template.json"
   "templates/constraints.template.json"

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "aether-colony",
-  "version": "5.1.0",
+  "version": "5.3.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-colony": "bin/npx-install.js"
+    "aether-colony": "bin/npx-entry.js"
   },
   "files": [
     "bin/",
@@ -31,7 +31,7 @@
     "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: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=>{const s=fs.readFileSync(f,'utf8'); if(s.trim()) JSON.parse(s)}); 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"
   },
@@ -69,5 +69,13 @@
     "commander": "^12.1.0",
     "js-yaml": "^4.1.0",
     "picocolors": "^1.1.1"
+  },
+  "overrides": {
+    "minimatch": "^9.0.7",
+    "brace-expansion": "^2.0.3",
+    "path-to-regexp": "^8.4.0",
+    "picomatch": "^4.0.4",
+    "tar": "^7.5.11",
+    "diff": "^8.0.3"
   }
 }

package/.aether/docs/plans/pheromone-display-plan.md

@@ -1,257 +0,0 @@
-# Pheromone Display Enhancement Plan
-
-**Created:** 2026-02-21
-**Status:** ✅ COMPLETED
-**Priority:** High - User-requested feature gap
-
----
-
-## Problem Statement
-
-The pheromone system works but is invisible:
-
-1. **Council command exists** - `/ant:council` proposes pheromones via multiple choice
-2. **Pheromone signals exist** - Stored in `.aether/data/pheromones.json`
-3. **Colony-prime loads them** - But only shows a count like "Primed: 2 signals"
-4. **User never sees them** - The actual content is hidden
-
-**User's exact words:** "I think it's important to create a significant plan here for how to display the pheromones that are being injected."
-
----
-
-## What Exists (Don't Rebuild)
-
-| Component | Location | Status |
-|-----------|----------|--------|
-| Council command | `.claude/commands/ant/council.md` | ✅ Works - multi-choice pheromone proposal |
-| Focus command | `.claude/commands/ant/focus.md` | ✅ Works - emits FOCUS signal |
-| Redirect command | `.claude/commands/ant/redirect.md` | ✅ Works - emits REDIRECT signal |
-| Feedback command | `.claude/commands/ant/feedback.md` | ✅ Works - emits FEEDBACK signal |
-| Pheromone storage | `.aether/data/pheromones.json` | ✅ Works - stores signals |
-| Pheromone-prime | `aether-utils.sh:6211` | ✅ Works - loads signals with decay |
-| Colony-prime | `aether-utils.sh:6337` | ✅ Works - combines wisdom + signals |
-| Pheromone-count | `aether-utils.sh:6036` | ✅ Works - counts active signals |
-
----
-
-## What's Missing
-
-### 1. **Pheromone Display Function** (aether-utils.sh)
-
-A new `pheromone-display` function that outputs a formatted table:
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   A C T I V E   P H E R O M O N E S
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🎯 FOCUS (Pay attention here)
-   1. [85%] "security" — injected 2d ago
-   2. [72%] "performance optimization" — injected 5d ago
-
-🚫 REDIRECT (Hard constraints - DO NOT do this)
-   1. [90%] "use ORM" — injected 1d ago
-   2. [68%] "jQuery" — injected 7d ago
-
-💬 FEEDBACK (Guidance to consider)
-   1. [65%] "prefer composition over inheritance" — injected 3d ago
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Total: 5 active signals | Decay: FOCUS 30d, REDIRECT 60d, FEEDBACK 90d
-```
-
-### 2. **Build Command Enhancement** (build.md)
-
-After Step 4 (Load Colony Context), add Step 4.1:
-
-```markdown
-### Step 4.1: Display Active Pheromones
-
-Run using the Bash tool:
-```bash
-bash .aether/aether-utils.sh pheromone-display
-```
-
-This displays the formatted pheromone table to the user so they can see what guidance is active.
-```
-
-### 3. **Status Command Enhancement** (status.md)
-
-Add pheromone summary to `/ant:status` output:
-
-```markdown
-### Pheromones Active
-
-🎯 FOCUS: 2 signals
-🚫 REDIRECT: 1 signal
-💬 FEEDBACK: 1 signal
-
-Run /ant:pheromones for full details
-```
-
-### 4. **New Pheromones Command** (pheromones.md)
-
-A dedicated command for viewing/managing pheromones:
-
-```markdown
----
-name: ant:pheromones
-description: "🎯🐜🚫🐜💬 View and manage active pheromone signals"
----
-
-Usage:
-  /ant:pheromones          # Display all active signals
-  /ant:pheromones focus    # Show only FOCUS signals
-  /ant:pheromones redirect # Show only REDIRECT signals
-  /ant:pheromones feedback # Show only FEEDBACK signals
-  /ant:pheromones clear    # Clear all expired signals
-  /ant:pheromones expire <id> # Expire a specific signal
-```
-
----
-
-## Implementation Plan
-
-### Phase 1: pheromone-display Function (aether-utils.sh)
-
-**Location:** After `pheromone-count` (~line 6058)
-
-```bash
-pheromone-display)
-  # Display active pheromones in formatted table
-  # Usage: pheromone-display [type]
-  #   type: Optional filter (focus/redirect/feedback)
-  # Returns: Formatted table string
-
-  pd_file="$DATA_DIR/pheromones.json"
-  pd_type="${1:-all}"
-  pd_now=$(date +%s)
-
-  if [[ ! -f "$pd_file" ]]; then
-    echo "No pheromones file found. Run /ant:init to initialize colony."
-    exit 0
-  fi
-
-  # Build display using same decay logic as pheromone-read
-  # ... (implementation details)
-```
-
-**Output format:**
-- Header with box drawing
-- Grouped by type (FOCUS, REDIRECT, FEEDBACK)
-- Each signal shows: effective strength %, content, age
-- Footer with totals and decay info
-
-### Phase 2: Update build.md
-
-Add Step 4.1 after colony-prime call to display pheromones visibly.
-
-### Phase 3: Update status.md
-
-Add pheromone summary section after memory health display.
-
-### Phase 4: Create pheromones.md Command
-
-New slash command for dedicated pheromone viewing and management.
-
----
-
-## Display Locations
-
-| Where | What | When |
-|-------|------|------|
-| `/ant:build` | Full table | Before spawning workers |
-| `/ant:status` | Summary counts | In colony overview |
-| `/ant:council` | After injection | Show what was added |
-| `/ant:pheromones` | Full table + management | On demand |
-| `/ant:continue` | Summary | After phase completion |
-
----
-
-## Visual Design
-
-### Full Table (for /ant:build, /ant:pheromones)
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   A C T I V E   P H E R O M O N E S
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🎯 FOCUS (Pay attention here)
-   1. [85%] "security"
-      └── injected 2d ago, expires in 28d
-   2. [72%] "performance optimization"
-      └── injected 5d ago, expires in 25d
-
-🚫 REDIRECT (Hard constraints - DO NOT do this)
-   1. [90%] "use ORM"
-      └── injected 1d ago, expires in 59d
-   2. [68%] "jQuery"
-      └── injected 7d ago, expires in 53d
-
-💬 FEEDBACK (Guidance to consider)
-   1. [65%] "prefer composition over inheritance"
-      └── injected 3d ago, expires in 87d
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-5 signals active | Decay rates: FOCUS 30d, REDIRECT 60d, FEEDBACK 90d
-```
-
-### Summary (for /ant:status)
-
-```
-┌─────────────────────────────────────────────────────────┐
-│ PHEROMONES                                               │
-├─────────────────────────────────────────────────────────┤
-│ 🎯 FOCUS: 2    🚫 REDIRECT: 1    💬 FEEDBACK: 1         │
-│                                                          │
-│ Strongest: "use ORM" [90%]                              │
-│ Newest: "security" [85%] - 2d ago                       │
-│                                                          │
-│ Run /ant:pheromones for details                         │
-└─────────────────────────────────────────────────────────┘
-```
-
-### Injection Confirmation (for /ant:council, /ant:focus, etc.)
-
-```
-✓ Pheromone injected:
-  🎯 FOCUS: "security"
-  Strength: 0.8 | Expires: 30d
-
-Active signals: 5
-```
-
----
-
-## Files to Create/Modify
-
-| File | Action | Purpose |
-|------|--------|---------|
-| `.aether/aether-utils.sh` | Modify | Add `pheromone-display` function |
-| `.claude/commands/ant/build.md` | Modify | Add Step 4.1 - display pheromones |
-| `.claude/commands/ant/status.md` | Modify | Add pheromone summary section |
-| `.claude/commands/ant/pheromones.md` | Create | New command for viewing/managing |
-| `.opencode/commands/ant/pheromones.md` | Create | OpenCode version |
-
----
-
-## Testing
-
-1. Run `/ant:focus "test signal"` and verify it appears in display
-2. Run `/ant:redirect "avoid this"` and verify it appears in display
-3. Run `/ant:build 1` and verify pheromone table shows before workers spawn
-4. Run `/ant:status` and verify pheromone summary appears
-5. Test decay: Create signal, wait, verify strength decreases
-
----
-
-## Success Criteria
-
-- [x] `/ant:build` displays full pheromone table before spawning workers
-- [x] `/ant:status` shows pheromone counts and strongest/newest
-- [x] `/ant:pheromones` command exists for dedicated viewing
-- [x] `/ant:council` displays what was injected after session (already existed)
-- [x] All signal types (FOCUS/REDIRECT/FEEDBACK) visible
-- [x] Decay strength shown as percentage
-- [x] Age and expiry shown per signal