aether-colony 1.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

@@ -0,0 +1,6 @@
+#!/bin/bash
+# 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,88 @@
+#!/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"
+  "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
+
+echo "Package validation passed."

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "aether-colony",
+  "version": "1.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-colony": "bin/npx-install.js"
+  },
+  "files": [
+    "bin/",
+    ".claude/commands/ant/",
+    ".claude/agents/ant/",
+    ".opencode/commands/ant/",
+    ".opencode/agents/",
+    ".opencode/opencode.json",
+    ".aether/",
+    "README.md",
+    "LICENSE",
+    "DISCLAIMER.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "preinstall": "bash bin/validate-package.sh 2>/dev/null || true",
+    "postinstall": "node bin/cli.js install --quiet",
+    "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 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"
+  },
+  "devDependencies": {
+    "ava": "^6.0.0",
+    "proxyquire": "^2.1.3",
+    "sinon": "^19.0.5"
+  },
+  "ava": {
+    "files": [
+      "tests/unit/**/*.test.js"
+    ],
+    "timeout": "30s"
+  },
+  "keywords": [
+    "claude-code",
+    "opencode",
+    "multi-agent",
+    "ant-colony",
+    "ai-orchestration",
+    "pheromone",
+    "autonomous-agents",
+    "multi-provider"
+  ],
+  "author": "Callum Cowie",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/calcosmic/Aether.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "js-yaml": "^4.1.0",
+    "picocolors": "^1.1.1"
+  }
+}