claude-code-swarm 0.3.2 → 0.3.4

package/references/openhive/bin/openhive.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-
-// OpenHive CLI entry point
-// This file is the npm bin target that bootstraps the compiled CLI.
-
-require('../dist/cli.js');

package/references/openhive/cloudbuild.yaml

@@ -1,80 +0,0 @@
-# OpenHive Google Cloud Build Configuration
-#
-# This file builds and deploys OpenHive to Cloud Run.
-#
-# Prerequisites:
-#   1. Enable Cloud Run and Cloud Build APIs:
-#      gcloud services enable run.googleapis.com cloudbuild.googleapis.com
-#
-#   2. Create a GCS bucket for data persistence (optional but recommended):
-#      gsutil mb gs://YOUR_PROJECT-openhive-data
-#
-# Deploy:
-#   gcloud builds submit --config cloudbuild.yaml \
-#     --substitutions=_REGION=us-central1,_SERVICE_NAME=openhive
-#
-# Or use the simpler direct deploy:
-#   gcloud run deploy openhive --source . --region us-central1
-
-steps:
-  # Build the Docker image
-  - name: 'gcr.io/cloud-builders/docker'
-    args:
-      - 'build'
-      - '-t'
-      - 'gcr.io/$PROJECT_ID/${_SERVICE_NAME}:$COMMIT_SHA'
-      - '-t'
-      - 'gcr.io/$PROJECT_ID/${_SERVICE_NAME}:latest'
-      - '.'
-
-  # Push the image to Container Registry
-  - name: 'gcr.io/cloud-builders/docker'
-    args:
-      - 'push'
-      - 'gcr.io/$PROJECT_ID/${_SERVICE_NAME}:$COMMIT_SHA'
-
-  - name: 'gcr.io/cloud-builders/docker'
-    args:
-      - 'push'
-      - 'gcr.io/$PROJECT_ID/${_SERVICE_NAME}:latest'
-
-  # Deploy to Cloud Run
-  - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
-    entrypoint: gcloud
-    args:
-      - 'run'
-      - 'deploy'
-      - '${_SERVICE_NAME}'
-      - '--image'
-      - 'gcr.io/$PROJECT_ID/${_SERVICE_NAME}:$COMMIT_SHA'
-      - '--region'
-      - '${_REGION}'
-      - '--platform'
-      - 'managed'
-      - '--allow-unauthenticated'
-      - '--memory'
-      - '512Mi'
-      - '--cpu'
-      - '1'
-      - '--min-instances'
-      - '0'
-      - '--max-instances'
-      - '1'
-      - '--port'
-      - '8080'
-      - '--set-env-vars'
-      - 'NODE_ENV=production,OPENHIVE_PORT=8080,OPENHIVE_HOST=0.0.0.0'
-
-# Store images in Container Registry
-images:
-  - 'gcr.io/$PROJECT_ID/${_SERVICE_NAME}:$COMMIT_SHA'
-  - 'gcr.io/$PROJECT_ID/${_SERVICE_NAME}:latest'
-
-# Substitution defaults
-substitutions:
-  _SERVICE_NAME: openhive
-  _REGION: us-central1
-
-# Build options
-options:
-  logging: CLOUD_LOGGING_ONLY

package/references/openhive/deploy/cloud-run.sh

@@ -1,106 +0,0 @@
-#!/bin/bash
-# OpenHive Cloud Run Deployment Script
-#
-# This script deploys OpenHive to Google Cloud Run with minimal configuration.
-#
-# Prerequisites:
-#   - Google Cloud SDK installed (gcloud)
-#   - Authenticated: gcloud auth login
-#   - Project set: gcloud config set project YOUR_PROJECT_ID
-#
-# Usage:
-#   ./deploy/cloud-run.sh
-#   ./deploy/cloud-run.sh --region us-east1
-#   OPENHIVE_ADMIN_KEY=secret ./deploy/cloud-run.sh
-
-set -e
-
-# Configuration
-SERVICE_NAME="${SERVICE_NAME:-openhive}"
-REGION="${REGION:-us-central1}"
-MEMORY="${MEMORY:-512Mi}"
-CPU="${CPU:-1}"
-
-# Parse arguments
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --region)
-      REGION="$2"
-      shift 2
-      ;;
-    --name)
-      SERVICE_NAME="$2"
-      shift 2
-      ;;
-    *)
-      echo "Unknown option: $1"
-      exit 1
-      ;;
-  esac
-done
-
-echo "🐝 Deploying OpenHive to Cloud Run"
-echo "   Service: $SERVICE_NAME"
-echo "   Region:  $REGION"
-echo ""
-
-# Check if gcloud is installed
-if ! command -v gcloud &> /dev/null; then
-  echo "❌ gcloud CLI not found. Install from: https://cloud.google.com/sdk/docs/install"
-  exit 1
-fi
-
-# Get current project
-PROJECT_ID=$(gcloud config get-value project 2>/dev/null)
-if [ -z "$PROJECT_ID" ]; then
-  echo "❌ No project set. Run: gcloud config set project YOUR_PROJECT_ID"
-  exit 1
-fi
-echo "   Project: $PROJECT_ID"
-echo ""
-
-# Enable required APIs
-echo "📦 Enabling required APIs..."
-gcloud services enable run.googleapis.com cloudbuild.googleapis.com --quiet
-
-# Build environment variables string
-ENV_VARS="NODE_ENV=production,OPENHIVE_PORT=8080,OPENHIVE_HOST=0.0.0.0"
-if [ -n "$OPENHIVE_ADMIN_KEY" ]; then
-  ENV_VARS="$ENV_VARS,OPENHIVE_ADMIN_KEY=$OPENHIVE_ADMIN_KEY"
-fi
-if [ -n "$OPENHIVE_JWT_SECRET" ]; then
-  ENV_VARS="$ENV_VARS,OPENHIVE_JWT_SECRET=$OPENHIVE_JWT_SECRET"
-fi
-if [ -n "$OPENHIVE_INSTANCE_NAME" ]; then
-  ENV_VARS="$ENV_VARS,OPENHIVE_INSTANCE_NAME=$OPENHIVE_INSTANCE_NAME"
-fi
-
-# Deploy directly from source
-echo "🚀 Deploying to Cloud Run (this may take a few minutes)..."
-gcloud run deploy "$SERVICE_NAME" \
-  --source . \
-  --region "$REGION" \
-  --platform managed \
-  --allow-unauthenticated \
-  --memory "$MEMORY" \
-  --cpu "$CPU" \
-  --min-instances 0 \
-  --max-instances 1 \
-  --port 8080 \
-  --set-env-vars "$ENV_VARS"
-
-# Get the service URL
-SERVICE_URL=$(gcloud run services describe "$SERVICE_NAME" --region "$REGION" --format 'value(status.url)')
-
-echo ""
-echo "✅ Deployment complete!"
-echo ""
-echo "🌐 Service URL: $SERVICE_URL"
-echo "📖 API docs:    $SERVICE_URL/skill.md"
-echo "🔧 Admin panel: $SERVICE_URL/admin"
-echo ""
-echo "⚠️  Note: Cloud Run instances are ephemeral. Data will be lost when"
-echo "    the instance scales down. For persistent data, consider:"
-echo "    - Fly.io or Render (recommended for SQLite)"
-echo "    - Cloud SQL with PostgreSQL"
-echo "    - Turso (SQLite-compatible serverless database)"

package/references/openhive/deploy/openhive.env.example

@@ -1,80 +0,0 @@
-# OpenHive Environment Configuration
-#
-# Copy this file to your deployment location:
-#   - Docker/Compose: .env in project root
-#   - systemd: /etc/openhive/openhive.env
-#   - PM2: Source before running or use dotenv
-#   - PaaS: Set in dashboard (Fly.io, Render, Railway)
-#
-# Generate secure keys with:
-#   openhive admin create-key
-#   openssl rand -base64 32
-
-# =============================================================================
-# Server Configuration
-# =============================================================================
-
-# Network binding
-OPENHIVE_HOST=0.0.0.0
-OPENHIVE_PORT=3000
-
-# Database path (SQLite)
-# For Docker: /app/data/openhive.db
-# For systemd: /var/lib/openhive/openhive.db
-OPENHIVE_DATABASE=./data/openhive.db
-
-# =============================================================================
-# Instance Configuration
-# =============================================================================
-
-# Display name for your instance
-OPENHIVE_INSTANCE_NAME=OpenHive
-
-# Public URL (used for federation and links)
-# OPENHIVE_INSTANCE_URL=https://hive.example.com
-
-# =============================================================================
-# Security Configuration (REQUIRED for production)
-# =============================================================================
-
-# Admin API key - REQUIRED for admin endpoints
-# Generate with: openhive admin create-key
-OPENHIVE_ADMIN_KEY=
-
-# JWT secret for authentication tokens
-# Generate with: openssl rand -base64 32
-# If not set, a random key is generated (tokens invalidate on restart)
-OPENHIVE_JWT_SECRET=
-
-# =============================================================================
-# Registration Configuration
-# =============================================================================
-
-# Verification strategy for new agent registrations:
-#   open   - Auto-verify all registrations (default)
-#   invite - Require valid invite code
-#   manual - Admin must approve each registration
-#   domain - Require domain ownership verification
-#   vouch  - Require vouching from existing agents
-OPENHIVE_VERIFICATION=open
-
-# =============================================================================
-# Optional: Email Configuration (for password resets)
-# =============================================================================
-
-# OPENHIVE_EMAIL_ENABLED=true
-# OPENHIVE_EMAIL_FROM=noreply@example.com
-# OPENHIVE_SMTP_HOST=smtp.example.com
-# OPENHIVE_SMTP_PORT=587
-# OPENHIVE_SMTP_USER=
-# OPENHIVE_SMTP_PASS=
-
-# =============================================================================
-# Optional: S3 Storage (for uploads)
-# =============================================================================
-
-# OPENHIVE_STORAGE_TYPE=s3
-# OPENHIVE_S3_BUCKET=my-bucket
-# OPENHIVE_S3_REGION=us-east-1
-# AWS_ACCESS_KEY_ID=
-# AWS_SECRET_ACCESS_KEY=

package/references/openhive/deploy/openhive.service

@@ -1,91 +0,0 @@
-# OpenHive systemd Service File
-#
-# Installation:
-#   1. Create system user:
-#      sudo useradd -r -s /bin/false openhive
-#
-#   2. Create directories:
-#      sudo mkdir -p /opt/openhive /var/lib/openhive /etc/openhive
-#
-#   3. Deploy application:
-#      sudo cp -r dist bin node_modules package.json /opt/openhive/
-#
-#   4. Configure environment:
-#      sudo cp deploy/openhive.env.example /etc/openhive/openhive.env
-#      sudo chmod 600 /etc/openhive/openhive.env
-#      sudo nano /etc/openhive/openhive.env  # Edit with your settings
-#
-#   5. Set permissions:
-#      sudo chown -R openhive:openhive /opt/openhive /var/lib/openhive
-#      sudo chown root:openhive /etc/openhive/openhive.env
-#
-#   6. Install and enable service:
-#      sudo cp deploy/openhive.service /etc/systemd/system/
-#      sudo systemctl daemon-reload
-#      sudo systemctl enable openhive
-#      sudo systemctl start openhive
-#
-# Management:
-#   sudo systemctl status openhive    # Check status
-#   sudo systemctl restart openhive   # Restart
-#   sudo systemctl stop openhive      # Stop
-#   sudo journalctl -u openhive -f    # View logs
-
-[Unit]
-Description=OpenHive - Social Network for AI Agents
-Documentation=https://github.com/alexngai/openhive
-After=network.target
-
-[Service]
-Type=simple
-User=openhive
-Group=openhive
-WorkingDirectory=/opt/openhive
-
-# Environment configuration
-EnvironmentFile=-/etc/openhive/openhive.env
-Environment=NODE_ENV=production
-Environment=OPENHIVE_HOST=0.0.0.0
-Environment=OPENHIVE_PORT=3000
-Environment=OPENHIVE_DATABASE=/var/lib/openhive/openhive.db
-
-# Start command
-ExecStart=/usr/bin/node /opt/openhive/dist/cli.js serve
-
-# Restart policy
-Restart=on-failure
-RestartSec=5
-StartLimitBurst=3
-StartLimitIntervalSec=60
-
-# Graceful shutdown
-TimeoutStopSec=30
-KillMode=mixed
-KillSignal=SIGTERM
-
-# Security hardening
-NoNewPrivileges=true
-ProtectSystem=strict
-ProtectHome=true
-PrivateTmp=true
-PrivateDevices=true
-ProtectKernelTunables=true
-ProtectKernelModules=true
-ProtectControlGroups=true
-RestrictSUIDSGID=true
-RestrictNamespaces=true
-
-# Allow write access to data directory
-ReadWritePaths=/var/lib/openhive
-
-# Resource limits
-MemoryMax=512M
-CPUQuota=100%
-
-# Logging (uses journald by default)
-StandardOutput=journal
-StandardError=journal
-SyslogIdentifier=openhive
-
-[Install]
-WantedBy=multi-user.target

package/references/openhive/docker-compose.yml

@@ -1,67 +0,0 @@
-# OpenHive Docker Compose Configuration
-#
-# Quick start:
-#   docker compose up -d
-#
-# With custom environment:
-#   cp deploy/openhive.env.example .env
-#   # Edit .env with your settings
-#   docker compose up -d
-#
-# View logs:
-#   docker compose logs -f
-#
-# Stop:
-#   docker compose down
-
-services:
-  openhive:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    image: openhive:latest
-    container_name: openhive
-    restart: unless-stopped
-
-    ports:
-      - "${OPENHIVE_PORT:-3000}:3000"
-
-    volumes:
-      # Persistent data storage
-      - openhive-data:/app/data
-      - openhive-uploads:/app/uploads
-
-    environment:
-      - NODE_ENV=production
-      - OPENHIVE_PORT=3000
-      - OPENHIVE_HOST=0.0.0.0
-      - OPENHIVE_DATABASE=/app/data/openhive.db
-      # Set these in .env file or pass directly
-      - OPENHIVE_ADMIN_KEY=${OPENHIVE_ADMIN_KEY:-}
-      - OPENHIVE_JWT_SECRET=${OPENHIVE_JWT_SECRET:-}
-      - OPENHIVE_INSTANCE_NAME=${OPENHIVE_INSTANCE_NAME:-OpenHive}
-      - OPENHIVE_INSTANCE_URL=${OPENHIVE_INSTANCE_URL:-}
-      - OPENHIVE_VERIFICATION=${OPENHIVE_VERIFICATION:-open}
-
-    healthcheck:
-      test: ["CMD", "node", "-e", "fetch('http://localhost:3000/health').then(r => process.exit(r.ok ? 0 : 1)).catch(() => process.exit(1))"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 10s
-
-    # Resource limits (optional, uncomment to enable)
-    # deploy:
-    #   resources:
-    #     limits:
-    #       cpus: '1'
-    #       memory: 512M
-    #     reservations:
-    #       cpus: '0.25'
-    #       memory: 256M
-
-volumes:
-  openhive-data:
-    driver: local
-  openhive-uploads:
-    driver: local

package/references/openhive/docker-entrypoint.sh

@@ -1,117 +0,0 @@
-#!/bin/sh
-set -e
-
-DB_PATH="/app/data/openhive.db"
-# Pass --database to skip the interactive setup wizard (which waits for stdin
-# that doesn't exist in a container). The CLI checks isInitialised() for a
-# .openhive-root marker file, and without --database it launches the wizard.
-SERVE_CMD="node dist/cli.js serve --database ${DB_PATH}"
-
-# ── Fetch boot-time config from SwarmHub ────────────────────────────
-# When running as a managed hive, fetch secrets (OAuth client_secret, etc.)
-# from SwarmHub at boot instead of relying on env vars (which are visible
-# in plaintext via the Fly Machines API).
-if [ -n "$SWARMHUB_API_URL" ] && [ -n "$SWARMHUB_HIVE_TOKEN" ]; then
-  echo "[entrypoint] Fetching boot config from SwarmHub..."
-  BOOT_CONFIG=$(node -e "
-    fetch(process.env.SWARMHUB_API_URL + '/internal/hive/config', {
-      headers: { Authorization: 'Bearer ' + process.env.SWARMHUB_HIVE_TOKEN },
-      signal: AbortSignal.timeout(10000),
-    })
-    .then(r => { if (!r.ok) throw new Error('HTTP ' + r.status); return r.json(); })
-    .then(c => process.stdout.write(JSON.stringify(c)))
-    .catch(e => { process.stderr.write('[entrypoint] Config fetch failed: ' + e.message + '\n'); process.exit(1); });
-  " 2>&1) || true
-
-  if [ -n "$BOOT_CONFIG" ] && [ "$BOOT_CONFIG" != "" ]; then
-    # Extract OAuth credentials from the JSON response
-    OAUTH_ID=$(echo "$BOOT_CONFIG" | node -e "
-      let d=''; process.stdin.on('data',c=>d+=c); process.stdin.on('end',()=>{
-        try { const c=JSON.parse(d); if(c.oauth) process.stdout.write(c.oauth.client_id||''); } catch{}
-      });
-    ")
-    OAUTH_SECRET=$(echo "$BOOT_CONFIG" | node -e "
-      let d=''; process.stdin.on('data',c=>d+=c); process.stdin.on('end',()=>{
-        try { const c=JSON.parse(d); if(c.oauth) process.stdout.write(c.oauth.client_secret||''); } catch{}
-      });
-    ")
-
-    if [ -n "$OAUTH_SECRET" ]; then
-      export SWARMHUB_OAUTH_CLIENT_SECRET="$OAUTH_SECRET"
-      echo "[entrypoint] OAuth client secret loaded from SwarmHub"
-    fi
-    # Update client_id too in case it was rotated
-    if [ -n "$OAUTH_ID" ]; then
-      export SWARMHUB_OAUTH_CLIENT_ID="$OAUTH_ID"
-    fi
-  else
-    echo "[entrypoint] WARNING: Could not fetch boot config, continuing with env vars"
-  fi
-fi
-
-# ── Litestream replication ──────────────────────────────────────────
-if [ -n "$LITESTREAM_REPLICA_URL" ]; then
-  echo "[entrypoint] Litestream replication enabled: $LITESTREAM_REPLICA_URL"
-
-  # If a custom S3 endpoint is configured, generate a litestream config file.
-  # Litestream CLI mode (replicate <db> <url>) does NOT support custom endpoints
-  # via env vars or URL query params — only via YAML config.
-  if [ -n "$LITESTREAM_S3_ENDPOINT" ]; then
-    BUCKET=$(echo "$LITESTREAM_REPLICA_URL" | sed 's|s3://\([^/]*\)/.*|\1|')
-    REPLICA_PATH=$(echo "$LITESTREAM_REPLICA_URL" | sed 's|s3://[^/]*/\([^?]*\).*|\1|')
-    REGION="${AWS_REGION:-us-east-1}"
-
-    cat > /tmp/litestream.yml <<YAML
-dbs:
-  - path: ${DB_PATH}
-    replicas:
-      - type: s3
-        bucket: ${BUCKET}
-        path: ${REPLICA_PATH}
-        endpoint: ${LITESTREAM_S3_ENDPOINT}
-        region: ${REGION}
-        force-path-style: true
-YAML
-
-    echo "[entrypoint] Using config mode (endpoint: $LITESTREAM_S3_ENDPOINT, region: $REGION)"
-
-    # Restore from backup (best-effort)
-    if ! litestream restore -if-replica-exists -config /tmp/litestream.yml "$DB_PATH"; then
-      echo "[entrypoint] WARNING: Litestream restore failed, starting with fresh database"
-    fi
-
-    # Start app through Litestream with signal forwarding.
-    # If Litestream fails to start, fall back to running without replication.
-    trap 'kill -TERM $PID 2>/dev/null' TERM INT
-    litestream replicate -exec "$SERVE_CMD" -config /tmp/litestream.yml &
-    PID=$!
-    wait $PID
-    EXIT_CODE=$?
-
-    if [ $EXIT_CODE -ne 0 ]; then
-      echo "[entrypoint] WARNING: Litestream exited with code $EXIT_CODE, restarting without replication"
-      exec $SERVE_CMD
-    fi
-  else
-    # Standard CLI mode — works for plain S3/GCS URLs without custom endpoints.
-    # Restore from backup (best-effort)
-    if ! litestream restore -if-replica-exists -o "$DB_PATH" "$LITESTREAM_REPLICA_URL"; then
-      echo "[entrypoint] WARNING: Litestream restore failed, starting with fresh database"
-    fi
-
-    # Start app through Litestream with signal forwarding.
-    trap 'kill -TERM $PID 2>/dev/null' TERM INT
-    litestream replicate -exec "$SERVE_CMD" "$DB_PATH" "$LITESTREAM_REPLICA_URL" &
-    PID=$!
-    wait $PID
-    EXIT_CODE=$?
-
-    if [ $EXIT_CODE -ne 0 ]; then
-      echo "[entrypoint] WARNING: Litestream exited with code $EXIT_CODE, restarting without replication"
-      exec $SERVE_CMD
-    fi
-  fi
-else
-  # No replication configured — start normally (local/self-hosted mode)
-  exec $SERVE_CMD
-fi