@adaptic/maestro 1.0.0

package/scripts/setup/init-agent.sh

@@ -0,0 +1,450 @@
+#!/bin/bash
+# =============================================================================
+# init-agent.sh — One-line setup for an Adaptic AI Agent Mac Mini
+# =============================================================================
+#
+# Usage:
+#   npm run init-agent
+#   # or directly:
+#   ./scripts/setup/init-agent.sh
+#
+# This script bootstraps a fresh clone/fork of an Adaptic AI agent repo on a
+# new Mac Mini. It:
+#   1. Validates prerequisites (Node, npm, Claude CLI)
+#   2. Installs npm dependencies
+#   3. Creates required state/log directories
+#   4. Installs global Claude Code settings (~/.claude/settings.json)
+#   5. Generates and installs macOS launchd plists
+#   6. Loads all launchd agents
+#   7. Runs a health check
+#
+# For identity refactoring (changing agent name/role), run:
+#   claude "/init-agent"
+#
+# =============================================================================
+
+set -e
+
+# ---------------------------------------------------------------------------
+# Configuration
+# ---------------------------------------------------------------------------
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+AGENT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+AGENT_NAME=$(basename "$AGENT_DIR")  # e.g. "sophie-ai", "jacob-ai"
+
+# Colours
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log()  { echo -e "${BLUE}[init]${NC} $1"; }
+ok()   { echo -e "${GREEN}  ✓${NC} $1"; }
+warn() { echo -e "${YELLOW}  ⚠${NC} $1"; }
+fail() { echo -e "${RED}  ✗${NC} $1"; exit 1; }
+
+# ---------------------------------------------------------------------------
+# Step 0: Banner
+# ---------------------------------------------------------------------------
+
+echo ""
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║           Maestro — AI Agent Machine Setup                  ║"
+echo "╠══════════════════════════════════════════════════════════════╣"
+echo "║  Agent directory:  $AGENT_DIR"
+echo "║  Agent name:       $AGENT_NAME"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 1: Prerequisites
+# ---------------------------------------------------------------------------
+
+log "Checking prerequisites..."
+
+# Node.js
+if ! command -v node &>/dev/null; then
+    fail "Node.js not found. Install via: brew install node"
+fi
+NODE_VERSION=$(node --version)
+ok "Node.js $NODE_VERSION"
+
+# npm
+if ! command -v npm &>/dev/null; then
+    fail "npm not found."
+fi
+NPM_VERSION=$(npm --version)
+ok "npm v$NPM_VERSION"
+
+# Check for legacy standalone npx (known to break on Node 25+)
+LEGACY_NPX="$HOME/.npm-global/lib/node_modules/npx"
+if [ -d "$LEGACY_NPX" ]; then
+    warn "Legacy standalone npx detected at $LEGACY_NPX"
+    warn "This causes 'cb.apply is not a function' errors on Node 25+"
+    read -p "  Remove it? (recommended) [Y/n]: " REMOVE_NPX
+    if [ "${REMOVE_NPX:-Y}" != "n" ] && [ "${REMOVE_NPX:-Y}" != "N" ]; then
+        npm uninstall -g npx 2>/dev/null || true
+        ok "Removed legacy npx"
+    fi
+fi
+
+# Claude CLI
+if ! command -v claude &>/dev/null; then
+    warn "Claude CLI not found. Install via: npm install -g @anthropic-ai/claude-code"
+    warn "Some features (scheduled triggers, init-agent command) require it."
+else
+    CLAUDE_VERSION=$(claude --version 2>/dev/null | head -1)
+    ok "Claude CLI: $CLAUDE_VERSION"
+fi
+
+# jq (used by hooks)
+if ! command -v jq &>/dev/null; then
+    warn "jq not found. Install via: brew install jq"
+    warn "Hook commands use jq — they'll fail silently without it."
+else
+    ok "jq $(jq --version 2>/dev/null)"
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 2: npm install
+# ---------------------------------------------------------------------------
+
+log "Installing npm dependencies..."
+cd "$AGENT_DIR"
+npm install --silent 2>&1 | tail -3
+ok "Dependencies installed"
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 3: Create directories
+# ---------------------------------------------------------------------------
+
+log "Creating state and log directories..."
+
+DIRS=(
+    "state/inbox/slack"
+    "state/inbox/gmail"
+    "state/inbox/calendar"
+    "state/inbox/sms"
+    "state/inbox/internal"
+    "state/triggers/priority"
+    "state/locks/outbound"
+    "state/queues"
+    "state/dashboards"
+    "state/polling"
+    "logs/polling"
+    "logs/workflows"
+    "logs/sessions"
+    "logs/audit"
+    "logs/sms"
+    "logs/monitor"
+    "logs/security"
+    "logs/evolution"
+    "memory/interactions"
+    "memory/profiles/users"
+    "memory/profiles/channels"
+    "memory/precedents"
+    "memory/templates"
+    "outputs/briefs"
+    "outputs/drafts"
+    "outputs/memos"
+    "outputs/research"
+    "outputs/tasks"
+    "outputs/sessions"
+)
+
+for dir in "${DIRS[@]}"; do
+    mkdir -p "$AGENT_DIR/$dir"
+done
+ok "Created ${#DIRS[@]} directories"
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 4: Global Claude Code settings
+# ---------------------------------------------------------------------------
+
+log "Setting up global Claude Code settings..."
+
+CLAUDE_SETTINGS_DIR="$HOME/.claude"
+CLAUDE_SETTINGS="$CLAUDE_SETTINGS_DIR/settings.json"
+mkdir -p "$CLAUDE_SETTINGS_DIR"
+
+if [ -f "$CLAUDE_SETTINGS" ]; then
+    BACKUP="$CLAUDE_SETTINGS.backup.$(date +%Y%m%d-%H%M%S)"
+    cp "$CLAUDE_SETTINGS" "$BACKUP"
+    warn "Existing settings backed up to $BACKUP"
+fi
+
+cat > "$CLAUDE_SETTINGS" << 'SETTINGS_EOF'
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "permissions": {
+    "allow": [
+      "Bash(*)",
+      "Read(*)",
+      "Write(*)",
+      "Edit(*)",
+      "Glob(*)",
+      "Grep(*)",
+      "WebFetch(*)",
+      "WebSearch(*)",
+      "mcp__plugin_chrome-devtools-mcp_chrome-devtools__*",
+      "mcp__plugin_playwright_playwright__*",
+      "mcp__plugin_context7_context7__*",
+      "mcp__claude_ai_Slack__*",
+      "mcp__claude_ai_Gmail__*",
+      "mcp__claude_ai_Google_Calendar__*",
+      "mcp__claude_ai_Granola__*",
+      "mcp__claude_ai_Linear__*",
+      "mcp__claude_ai_Airtable__*",
+      "mcp__claude_ai_Canva__*",
+      "mcp__claude_ai_Figma__*",
+      "mcp__claude_ai_Gamma__*",
+      "mcp__claude_ai_Consensus__*",
+      "mcp__claude_ai_Context7__*",
+      "mcp__claude_ai_Mermaid_Chart__*",
+      "mcp__claude_ai_Lumin__*",
+      "mcp__claude_ai_Calendly__*",
+      "mcp__claude_ai_Netlify__*",
+      "mcp__claude_ai_Zapier__*",
+      "mcp__claude_ai_tldraw__*",
+      "mcp__claude_ai_Jam__*",
+      "mcp__claude_ai_Metaview__*",
+      "mcp__claude_ai_Miro__*"
+    ],
+    "deny": [
+      "Bash(rm -rf /)",
+      "Bash(sudo rm -rf *)",
+      "Bash(mkfs *)",
+      "Bash(dd if=/dev/zero *)"
+    ]
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx ruflo@latest hooks pre-command --command '{}' --validate-safety true --prepare-resources true"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx ruflo@latest hooks pre-edit --file '{}' --auto-assign-agents true --load-context true"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx ruflo@latest hooks post-command --command '{}' --track-metrics true --store-results true"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx ruflo@latest hooks post-edit --file '{}' --format true --update-memory true"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx ruflo@latest hooks session-start"
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx ruflo@latest hooks session-end --generate-summary true --persist-state true --export-metrics true",
+            "timeout": 120,
+            "async": true
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx ruflo@latest hooks compact-guidance --preserve-critical true"
+          }
+        ]
+      }
+    ]
+  },
+  "enabledPlugins": {
+    "frontend-design@claude-plugins-official": true,
+    "superpowers@claude-plugins-official": true,
+    "context7@claude-plugins-official": true,
+    "code-review@claude-plugins-official": true,
+    "code-simplifier@claude-plugins-official": true,
+    "feature-dev@claude-plugins-official": true,
+    "playwright@claude-plugins-official": true,
+    "ralph-loop@claude-plugins-official": true,
+    "claude-md-management@claude-plugins-official": true,
+    "commit-commands@claude-plugins-official": true,
+    "skill-creator@claude-plugins-official": true,
+    "pr-review-toolkit@claude-plugins-official": true,
+    "claude-code-setup@claude-plugins-official": true,
+    "agent-sdk-dev@claude-plugins-official": true,
+    "plugin-dev@claude-plugins-official": true,
+    "hookify@claude-plugins-official": true,
+    "huggingface-skills@claude-plugins-official": true,
+    "railway@claude-plugins-official": true,
+    "netlify-skills@claude-plugins-official": true,
+    "telegram@claude-plugins-official": true,
+    "chrome-devtools-mcp@claude-plugins-official": true,
+    "remember@claude-plugins-official": true,
+    "mcp-server-dev@claude-plugins-official": true,
+    "zapier@claude-plugins-official": true,
+    "explanatory-output-style@claude-plugins-official": true,
+    "learning-output-style@claude-plugins-official": true
+  },
+  "effortLevel": "high",
+  "skipDangerousModePermissionPrompt": true
+}
+SETTINGS_EOF
+
+ok "Global Claude settings installed"
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 5: Generate and install launchd plists
+# ---------------------------------------------------------------------------
+
+log "Installing macOS launchd agents..."
+
+LAUNCH_AGENTS_DIR="$HOME/Library/LaunchAgents"
+PLIST_TEMPLATE_DIR="$AGENT_DIR/scripts/local-triggers/plists"
+mkdir -p "$LAUNCH_AGENTS_DIR"
+
+if [ ! -d "$PLIST_TEMPLATE_DIR" ]; then
+    warn "No plist templates found at $PLIST_TEMPLATE_DIR — skipping launchd setup"
+else
+    for plist in "$PLIST_TEMPLATE_DIR"/*.plist; do
+        PLIST_NAME=$(basename "$plist")
+        LABEL=$(basename "$plist" .plist)
+        DST="$LAUNCH_AGENTS_DIR/$PLIST_NAME"
+
+        # Unload if already loaded
+        launchctl unload "$DST" 2>/dev/null || true
+
+        # Copy the template
+        cp "$plist" "$DST"
+
+        # Substitute the agent directory path in case the template has a different one
+        # Handles both legacy (sophie-ai) and current (maestro) path patterns
+        sed -i '' "s|/Users/[^<]*/sophie-ai|$AGENT_DIR|g; s|/Users/[^<]*/maestro|$AGENT_DIR|g" "$DST" 2>/dev/null || true
+
+        # Load
+        launchctl load "$DST"
+        ok "Loaded: $LABEL"
+    done
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 6: Environment file
+# ---------------------------------------------------------------------------
+
+log "Checking environment configuration..."
+
+ENV_FILE="$AGENT_DIR/.env"
+if [ ! -f "$ENV_FILE" ]; then
+    cat > "$ENV_FILE" << 'ENV_EOF'
+# Maestro — AI Agent Environment Variables
+# See .env.example for full documentation of all variables
+
+# Slack
+SLACK_USER_TOKEN=
+SLACK_BOT_TOKEN=
+SLACK_SIGNING_SECRET=
+
+# Gmail (OAuth)
+GMAIL_CLIENT_ID=
+GMAIL_CLIENT_SECRET=
+GMAIL_REFRESH_TOKEN=
+
+# Google Calendar
+GCAL_CLIENT_ID=
+GCAL_CLIENT_SECRET=
+GCAL_REFRESH_TOKEN=
+
+# Twilio (SMS/Phone)
+TWILIO_ACCOUNT_SID=
+TWILIO_AUTH_TOKEN=
+TWILIO_PHONE_NUMBER=
+
+# Gemini (Media generation)
+GEMINI_API_KEY=
+
+# Cloudflare Tunnel
+TUNNEL_TOKEN=
+ENV_EOF
+    warn "Created .env template — fill in your API keys before running"
+else
+    ok ".env file exists"
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Step 7: Health check
+# ---------------------------------------------------------------------------
+
+log "Running health check..."
+
+if [ -f "$AGENT_DIR/scripts/healthcheck.sh" ]; then
+    bash "$AGENT_DIR/scripts/healthcheck.sh" 2>&1 | head -20 || true
+else
+    warn "healthcheck.sh not found — skipping"
+fi
+
+echo ""
+
+# ---------------------------------------------------------------------------
+# Done
+# ---------------------------------------------------------------------------
+
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║                    Setup Complete                           ║"
+echo "╠══════════════════════════════════════════════════════════════╣"
+echo "║                                                             ║"
+echo "║  Next steps:                                                ║"
+echo "║                                                             ║"
+echo "║  1. Fill in API keys in .env                                ║"
+echo "║  2. Customise identity:                                     ║"
+echo "║     cd $AGENT_DIR"
+echo "║     claude \"/init-maestro\"                                  ║"
+echo "║                                                             ║"
+echo "║  3. Verify launchd agents:                                  ║"
+echo "║     launchctl list | grep adaptic                           ║"
+echo "║                                                             ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""

package/scripts/slack-events-ctl.sh

@@ -0,0 +1,177 @@
+#!/bin/bash
+# slack-events-ctl.sh — Start/stop/restart the Slack Events API server
+#
+# Usage:
+#   ./scripts/slack-events-ctl.sh start    — Start the server (background)
+#   ./scripts/slack-events-ctl.sh stop     — Stop the server
+#   ./scripts/slack-events-ctl.sh restart  — Restart the server
+#   ./scripts/slack-events-ctl.sh status   — Check if running
+#   ./scripts/slack-events-ctl.sh health   — Query health endpoint
+#   ./scripts/slack-events-ctl.sh logs     — Tail today's log
+#
+set -e
+
+SOPHIE_AI_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PID_FILE="$SOPHIE_AI_DIR/state/locks/slack-events-server.pid"
+LOG_DIR="$SOPHIE_AI_DIR/logs/polling"
+DATE=$(date +%Y-%m-%d)
+PORT="${SLACK_EVENTS_PORT:-3100}"
+
+# Find node
+if command -v node >/dev/null 2>&1; then
+    NODE_BIN=$(command -v node)
+elif [ -x /opt/homebrew/bin/node ]; then
+    NODE_BIN="/opt/homebrew/bin/node"
+elif [ -x /usr/local/bin/node ]; then
+    NODE_BIN="/usr/local/bin/node"
+else
+    echo "[SLACK-EVENTS] ERROR: node not found"
+    exit 1
+fi
+
+start_server() {
+    # Check if already running
+    if [ -f "$PID_FILE" ]; then
+        PID=$(cat "$PID_FILE")
+        if kill -0 "$PID" 2>/dev/null; then
+            echo "[SLACK-EVENTS] Already running (PID $PID)"
+            return 0
+        else
+            echo "[SLACK-EVENTS] Stale PID file, cleaning up"
+            rm -f "$PID_FILE"
+        fi
+    fi
+
+    # Check if port is in use by something else
+    if lsof -i ":$PORT" -sTCP:LISTEN >/dev/null 2>&1; then
+        EXISTING_PID=$(lsof -i ":$PORT" -sTCP:LISTEN -t 2>/dev/null | head -1)
+        echo "[SLACK-EVENTS] Port $PORT already in use by PID $EXISTING_PID"
+        echo "[SLACK-EVENTS] Stop that process first, or set SLACK_EVENTS_PORT"
+        return 1
+    fi
+
+    mkdir -p "$LOG_DIR" "$(dirname "$PID_FILE")"
+
+    echo "[SLACK-EVENTS] Starting server on port $PORT..."
+    cd "$SOPHIE_AI_DIR"
+
+    # Source .env for environment variables
+    if [ -f "$SOPHIE_AI_DIR/.env" ]; then
+        set -a
+        source "$SOPHIE_AI_DIR/.env"
+        set +a
+    fi
+
+    "$NODE_BIN" "$SOPHIE_AI_DIR/scripts/slack-events-server.mjs" \
+        >> "$LOG_DIR/$DATE-slack-events.log" 2>&1 &
+
+    SERVER_PID=$!
+    echo "$SERVER_PID" > "$PID_FILE"
+
+    # Wait a moment and verify it started
+    sleep 1
+    if kill -0 "$SERVER_PID" 2>/dev/null; then
+        echo "[SLACK-EVENTS] Started (PID $SERVER_PID) on port $PORT"
+    else
+        echo "[SLACK-EVENTS] Failed to start — check $LOG_DIR/$DATE-slack-events.log"
+        rm -f "$PID_FILE"
+        return 1
+    fi
+}
+
+stop_server() {
+    if [ -f "$PID_FILE" ]; then
+        PID=$(cat "$PID_FILE")
+        if kill -0 "$PID" 2>/dev/null; then
+            echo "[SLACK-EVENTS] Stopping (PID $PID)..."
+            kill "$PID"
+            # Wait up to 5 seconds for graceful shutdown
+            for i in $(seq 1 5); do
+                if ! kill -0 "$PID" 2>/dev/null; then
+                    break
+                fi
+                sleep 1
+            done
+            if kill -0 "$PID" 2>/dev/null; then
+                echo "[SLACK-EVENTS] Force killing..."
+                kill -9 "$PID" 2>/dev/null
+            fi
+            echo "[SLACK-EVENTS] Stopped"
+        else
+            echo "[SLACK-EVENTS] Not running (stale PID)"
+        fi
+        rm -f "$PID_FILE"
+    else
+        # Try to find by port
+        PID=$(lsof -i ":$PORT" -sTCP:LISTEN -t 2>/dev/null | head -1)
+        if [ -n "$PID" ]; then
+            echo "[SLACK-EVENTS] Found server on port $PORT (PID $PID), stopping..."
+            kill "$PID"
+            echo "[SLACK-EVENTS] Stopped"
+        else
+            echo "[SLACK-EVENTS] Not running"
+        fi
+    fi
+}
+
+check_status() {
+    if [ -f "$PID_FILE" ]; then
+        PID=$(cat "$PID_FILE")
+        if kill -0 "$PID" 2>/dev/null; then
+            echo "[SLACK-EVENTS] Running (PID $PID) on port $PORT"
+            return 0
+        else
+            echo "[SLACK-EVENTS] Not running (stale PID file)"
+            return 1
+        fi
+    else
+        PID=$(lsof -i ":$PORT" -sTCP:LISTEN -t 2>/dev/null | head -1)
+        if [ -n "$PID" ]; then
+            echo "[SLACK-EVENTS] Running on port $PORT (PID $PID, no PID file)"
+            return 0
+        else
+            echo "[SLACK-EVENTS] Not running"
+            return 1
+        fi
+    fi
+}
+
+check_health() {
+    HEALTH=$(curl -s --max-time 3 "http://localhost:$PORT/health" 2>/dev/null)
+    if [ -n "$HEALTH" ]; then
+        echo "$HEALTH" | python3 -m json.tool 2>/dev/null || echo "$HEALTH"
+    else
+        echo "[SLACK-EVENTS] Health check failed — server not responding on port $PORT"
+        return 1
+    fi
+}
+
+tail_logs() {
+    LOG_FILE="$LOG_DIR/$DATE-slack-events.log"
+    JSONL_FILE="$LOG_DIR/$DATE-slack-events.jsonl"
+    if [ -f "$JSONL_FILE" ]; then
+        echo "=== Structured log ($JSONL_FILE) ==="
+        tail -20 "$JSONL_FILE"
+    fi
+    if [ -f "$LOG_FILE" ]; then
+        echo ""
+        echo "=== Console log ($LOG_FILE) ==="
+        tail -30 "$LOG_FILE"
+    fi
+    if [ ! -f "$LOG_FILE" ] && [ ! -f "$JSONL_FILE" ]; then
+        echo "[SLACK-EVENTS] No logs for today"
+    fi
+}
+
+case "${1:-status}" in
+    start)   start_server ;;
+    stop)    stop_server ;;
+    restart) stop_server; sleep 1; start_server ;;
+    status)  check_status ;;
+    health)  check_health ;;
+    logs)    tail_logs ;;
+    *)
+        echo "Usage: $0 {start|stop|restart|status|health|logs}"
+        exit 1
+        ;;
+esac