aether-colony 5.2.1 → 5.3.0

package/bin/lib/interactive-setup.js

@@ -0,0 +1,251 @@
+/**
+ * interactive-setup.js — Interactive menu for npx aether-colony
+ *
+ * Displays an environment-aware menu with three options:
+ *   [1] Full setup    — Install globally + set up this repo
+ *   [2] Global only   — Install hub, commands, and agents (~/.aether/)
+ *   [3] Repo only     — Set up Aether in this directory (.aether/)
+ *
+ * Zero npm dependencies — uses built-in Node readline.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+
+const { BANNER } = require('./banner');
+
+const VERSION = require('../../package.json').version;
+const HOME_DIR = os.homedir();
+const HUB_VERSION_PATH = path.join(HOME_DIR, '.aether', 'version.json');
+
+/**
+ * Detect the current environment state.
+ * @returns {{ hubInstalled: boolean, hasAether: boolean, isProjectDir: boolean }}
+ */
+function detectEnvironment() {
+  const cwd = process.cwd();
+
+  const hubInstalled = fs.existsSync(HUB_VERSION_PATH);
+
+  const hasAether = fs.existsSync(path.join(cwd, '.aether', 'aether-utils.sh'));
+
+  const isProjectDir =
+    fs.existsSync(path.join(cwd, '.git')) ||
+    fs.existsSync(path.join(cwd, 'package.json')) ||
+    fs.existsSync(path.join(cwd, 'Makefile')) ||
+    fs.existsSync(path.join(cwd, 'pyproject.toml')) ||
+    fs.existsSync(path.join(cwd, 'Cargo.toml'));
+
+  return { hubInstalled, hasAether, isProjectDir };
+}
+
+/**
+ * Choose the context-sensitive default menu option.
+ * @param {{ hubInstalled: boolean, hasAether: boolean, isProjectDir: boolean }} env
+ * @returns {1|2|3}
+ */
+function getDefaultOption(env) {
+  if (!env.hubInstalled && env.isProjectDir) return 1;
+  if (!env.hubInstalled) return 2;
+  if (env.hubInstalled && !env.hasAether) return 3;
+  return 1;
+}
+
+/**
+ * Readline promise helper.
+ * @param {readline.Interface} rl
+ * @param {string} question
+ * @returns {Promise<string>}
+ */
+function prompt(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+/**
+ * Log a message with 🐜 ant prefix.
+ * @param {string} msg
+ */
+function log(msg) {
+  console.log(`🐜 ${msg}`);
+}
+
+/**
+ * Main interactive setup entry point.
+ * Handles --global, --repo, --yes flags and non-TTY environments.
+ */
+async function interactiveSetup() {
+  const args = process.argv.slice(2);
+  const flagGlobal = args.includes('--global');
+  const flagRepo = args.includes('--repo');
+  const flagYes = args.includes('--yes');
+
+  // Import performGlobalInstall lazily to avoid circular require issues
+  const { performGlobalInstall } = require('../cli');
+  const { initializeRepo } = require('./init');
+
+  const env = detectEnvironment();
+
+  // Non-TTY: auto-pick default without prompting
+  if (!process.stdin.isTTY && !flagGlobal && !flagRepo && !flagYes) {
+    const choice = getDefaultOption(env);
+    await executeChoice(choice, env, performGlobalInstall, initializeRepo);
+    return;
+  }
+
+  // Flag shortcuts: skip menu entirely
+  if (flagGlobal) {
+    await executeChoice(2, env, performGlobalInstall, initializeRepo);
+    return;
+  }
+  if (flagRepo) {
+    await executeChoice(3, env, performGlobalInstall, initializeRepo);
+    return;
+  }
+
+  // Already fully set up: offer refresh
+  if (env.hubInstalled && env.hasAether) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      console.log(BANNER);
+      console.log(`  🐜 Aether Colony v${VERSION}\n`);
+      log('Aether is already set up in this directory.');
+
+      let answer;
+      if (flagYes) {
+        answer = 'y';
+      } else {
+        answer = await prompt(rl, '\n  Already set up. Refresh? (y/n) [n]: ');
+      }
+
+      if (answer.trim().toLowerCase() === 'y') {
+        await executeChoice(1, env, performGlobalInstall, initializeRepo);
+      } else {
+        log('Nothing changed. Run /ant:init "your goal" to start a colony.');
+      }
+    } finally {
+      rl.close();
+    }
+    return;
+  }
+
+  // Interactive menu
+  const defaultChoice = flagYes ? getDefaultOption(env) : null;
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log(BANNER);
+    console.log(`  🐜 Aether Colony v${VERSION}\n`);
+
+    const defaultOption = getDefaultOption(env);
+    const option3Disabled = !env.isProjectDir;
+
+    console.log('  🐜 What would you like to do?\n');
+    console.log(`  [1] Full setup    — Install globally + set up this repo${defaultOption === 1 ? ' (recommended)' : ''}`);
+    console.log(`  [2] Global only   — Install hub, commands, and agents (~/.aether/)${defaultOption === 2 ? ' (recommended)' : ''}`);
+    if (option3Disabled) {
+      console.log('  [3] Repo only     — (not available: no project found in current directory)');
+    } else {
+      console.log(`  [3] Repo only     — Set up Aether in this directory (.aether/)${defaultOption === 3 ? ' (recommended)' : ''}`);
+    }
+    console.log('');
+
+    let choice;
+    if (flagYes) {
+      choice = defaultOption;
+      console.log(`  Auto-selected [${choice}] (--yes flag)\n`);
+    } else {
+      const raw = await prompt(rl, `  Enter choice [${defaultOption}]: `);
+      const trimmed = raw.trim();
+      choice = trimmed === '' ? defaultOption : parseInt(trimmed, 10);
+    }
+
+    if (isNaN(choice) || choice < 1 || choice > 3) {
+      console.error('\n  Invalid choice. Please run again and select 1, 2, or 3.\n');
+      process.exit(1);
+    }
+
+    if (choice === 3 && option3Disabled) {
+      console.error('\n  Option 3 is not available outside a project directory.\n');
+      process.exit(1);
+    }
+
+    await executeChoice(choice, env, performGlobalInstall, initializeRepo);
+  } finally {
+    rl.close();
+  }
+}
+
+/**
+ * Execute the selected menu option.
+ * @param {1|2|3} choice
+ * @param {{ hubInstalled: boolean, hasAether: boolean, isProjectDir: boolean }} env
+ * @param {Function} performGlobalInstall
+ * @param {Function} initializeRepo
+ */
+async function executeChoice(choice, env, performGlobalInstall, initializeRepo) {
+  const cwd = process.cwd();
+
+  if (choice === 1) {
+    log('Running full setup...');
+    await performGlobalInstall();
+    const result = await initializeRepo(cwd, { setupOnly: true });
+    printRepoSuccess(result);
+  } else if (choice === 2) {
+    log('Running global install...');
+    await performGlobalInstall();
+    printGlobalSuccess();
+  } else if (choice === 3) {
+    if (!env.hubInstalled) {
+      console.error('\n  Aether hub not installed. Run without --repo to install globally first.\n');
+      process.exit(1);
+    }
+    log('Setting up this repository...');
+    const result = await initializeRepo(cwd, { setupOnly: true });
+    printRepoSuccess(result);
+  }
+}
+
+/**
+ * Print success message after global install.
+ */
+function printGlobalSuccess() {
+  console.log('');
+  console.log('  🐜 Global install complete!');
+  console.log('');
+  console.log('  Next steps:');
+  console.log('    cd into a project, then run: npx aether-colony --repo');
+  console.log('    Or: aether init --goal "your goal"');
+  console.log('  🐜🐜🐜')
+  console.log('');
+}
+
+/**
+ * Print success message after repo setup.
+ * @param {{ success: boolean, filesCopied?: number }} result
+ */
+function printRepoSuccess(result) {
+  if (!result || !result.success) {
+    console.error('\n  Repo setup failed. Check that the Aether hub is installed.\n');
+    return;
+  }
+  console.log('');
+  console.log('  🐜 Aether is ready!');
+  if (result.filesCopied != null) {
+    console.log(`  ${result.filesCopied} system files synced to .aether/`);
+  }
+  console.log('');
+  console.log('  Next steps:');
+  console.log('    In Claude Code: /ant:init "your goal"');
+  console.log('    Or terminal:    aether init --goal "your goal"');
+  console.log('  🐜🐜🐜');
+  console.log('');
+}
+
+module.exports = {
+  interactiveSetup,
+  detectEnvironment,
+  getDefaultOption,
+  executeChoice,
+};

package/bin/npx-entry.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * npx-entry.js — Entry point for `npx aether-colony`
+ *
+ * With no subcommand: launches interactive setup menu.
+ * With a subcommand (e.g. `npx aether-colony install`): delegates to full CLI.
+ */
+
+const args = process.argv.slice(2);
+
+// If a subcommand is provided (not a flag), delegate to the full CLI
+if (args.length > 0 && !args[0].startsWith('-')) {
+  const { run } = require('./cli.js');
+  run();
+} else {
+  const { interactiveSetup } = require('./lib/interactive-setup');
+  interactiveSetup().catch(err => {
+    console.error('Setup failed:', err.message);
+    process.exit(1);
+  });
+}

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.2.1",
+  "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/",