feat(hermes): add secure runtime and Tailscale integration

.env.example

@@ -108,6 +108,13 @@ META_APP_SECRET=
 LINKEDIN_CLIENT_ID=
 LINKEDIN_CLIENT_SECRET=
 
+# ── License — headless auto-activation ───────────────
+# Set this to the email used in your first manual license registration.
+# On startup, EvoNexus calls /v1/register/auto silently and skips the manual
+# setup screen. Falls back to manual setup if the email isn't registered yet.
+# Leave empty (or unset) to keep the default behavior.
+# EVOLUTION_OPERATOR_EMAIL=operator@example.com
+
 # ── Evolution API ────────────────────────────────────
 # Your Evolution API instance URL and global API key
 EVOLUTION_API_URL=
@@ -242,3 +249,52 @@ AI_IMG_CREATOR_GEMINI_KEY=
 # DB_REDIS_1_ALLOW_WRITE=false
 # DB_REDIS_1_QUERY_TIMEOUT=30
 # DB_REDIS_1_MAX_ROWS=1000
+
+# ── Tailscale VPN ─────────────────────────────────────────
+# Managed via Dashboard → Integrations → Network tab.
+# The Auth Key is entered transiently in the UI and is never stored by EvoNexus.
+# Generate at: console.tailscale.com → Settings → Keys
+# Optional hostname override (RFC 1123 label, max 63 characters):
+# EVONEXUS_TAILSCALE_HOSTNAME=evonexus-hermes
+#
+# Persistence: /var/lib/tailscale is stored in the 'tailscale-state'
+# Docker volume, so the node reconnects automatically after restarts.
+#
+# ── Hermes Runtime ──────────────────────────────────────────
+# Configure provider credentials through Dashboard → Providers or hermes setup.
+# These variables follow the native Hermes Agent environment contract.
+# HERMES_MODEL=anthropic/claude-sonnet-4
+# HERMES_MAX_ITERATIONS=30
+# OPENROUTER_API_KEY=
+# ANTHROPIC_API_KEY=
+# DEEPSEEK_API_KEY=
+# OPENAI_API_KEY=
+# OPENAI_BASE_URL=
+# Emergency fail-closed switch for all Hermes executions:
+# HERMES_KILL_SWITCH=0
+#
+# ── Hermes Control API (optional, disabled without a token) ────────────
+# Use independent, high-entropy bearer tokens. Scopes are comma-separated
+# and fail closed when omitted. See dashboard/backend/routes/control_api.py.
+# HERMES_CONTROL_API_TOKEN=
+# HERMES_CONTROL_API_TOKEN_PREVIOUS=
+# HERMES_CONTROL_API_SCOPES=health:read,projects:read,tickets:read
+#
+# ── Hermes Dashboard Auth (remote access via Tailscale) ───────────────────
+# When set, Hermes binds 0.0.0.0 (enabling remote access) and requires
+# Basic Auth. The proxy injects credentials automatically for the iframe.
+# Use a strong plaintext password here; Hermes hashes/validates it internally.
+# Leave both values empty to bind Hermes to 127.0.0.1 without direct remote access.
+# EVONEXUS_HERMES_USERNAME=hermes-admin
+# EVONEXUS_HERMES_PASSWORD=
+# Optional native Hermes API server. Disabled by default; enabling it requires a key.
+# EVONEXUS_HERMES_API_ENABLED=false
+# EVONEXUS_HERMES_API_KEY=
+# HERMES_UI_PORT=9119
+# HERMES_API_PORT=8642
+#
+# ── Immutable deployment images ─────────────────────────────
+# Required by docker-compose.hub.yml, docker-compose.proxy.yml and the Swarm stack.
+# EVONEXUS_IMAGE_TAG=sha-abcdef0
+# Optional registry override; official images default to Docker Hub/evoapicloud.
+# EVONEXUS_IMAGE_REGISTRY=evoapicloud

.github/workflows/ci.yml

@@ -5,15 +5,27 @@ on:
     branches: [develop, main]
     paths:
       - "dashboard/**"
+      - "ADWs/**"
+      - "config/**"
       - "tests/**"
+      - "Dockerfile*"
+      - "docker-compose*.yml"
+      - "evonexus.stack.yml"
+      - "start-dashboard.sh"
       - "pyproject.toml"
       - "uv.lock"
       - ".github/workflows/ci.yml"
   push:
     branches: [develop, main]
     paths:
       - "dashboard/**"
+      - "ADWs/**"
+      - "config/**"
       - "tests/**"
+      - "Dockerfile*"
+      - "docker-compose*.yml"
+      - "evonexus.stack.yml"
+      - "start-dashboard.sh"
       - "pyproject.toml"
       - "uv.lock"
       - ".github/workflows/ci.yml"
@@ -43,7 +55,23 @@ jobs:
         run: uv sync --frozen --dev
 
       - name: Run backend tests
-        run: uv run python -m pytest tests/backend/test_auth_security.py tests/backend/test_health_routes.py
+        run: >-
+          uv run python -m pytest -q
+          tests/backend
+          tests/db
+          tests/heartbeats
+          tests/test_deployment_images.py
+          ADWs/test_hermes_integration.py
+          ADWs/test_runtime_policy.py
+
+      - name: Validate deployment manifests
+        env:
+          EVONEXUS_IMAGE_TAG: sha-ci
+        run: |
+          bash -n start-dashboard.sh
+          docker compose -f docker-compose.hub.yml config >/dev/null
+          docker compose -f docker-compose.proxy.yml config >/dev/null
+          docker stack config -c evonexus.stack.yml >/dev/null
 
   terminal-server:
     runs-on: ubuntu-latest
@@ -81,12 +109,16 @@ jobs:
         with:
           node-version: "22"
           cache: npm
-          cache-dependency-path: dashboard/frontend/package-lock.json
+          cache-dependency-path: dashboard/package-lock.json
 
       - name: Install frontend dependencies
-        working-directory: dashboard/frontend
+        working-directory: dashboard
         run: npm ci
 
+      - name: Run frontend tests
+        working-directory: dashboard
+        run: npm run test --workspace frontend
+
       - name: Build frontend
-        working-directory: dashboard/frontend
-        run: npm run build
+        working-directory: dashboard
+        run: npm run build --workspace frontend

.github/workflows/docker-publish.yml

@@ -2,20 +2,20 @@ name: Build & Publish Docker Images (Swarm)
 
 # Builds evo-nexus-runtime and evo-nexus-dashboard images using the
 # Swarm-specific Dockerfiles (Dockerfile.swarm and Dockerfile.swarm.dashboard)
-# and pushes them to Docker Hub under the `evoapicloud` namespace. The
-# upstream Dockerfile and Dockerfile.dashboard are intentionally NOT used
-# here: they are for local `docker compose up`, while these variants carry
-# the Swarm-specific bootstrap (entrypoint.sh, start-dashboard.sh, terminal-
-# server native build, both CLIs on PATH).
+# and pushes them to Docker Hub. Uses native arm64 runners instead of QEMU
+# emulation to avoid 6h+ build times on the dashboard image.
+#
+# Strategy: build each platform natively in parallel, then merge into
+# a single multi-arch manifest via docker buildx imagetools.
 #
 # Triggers:
-#   * push to main            -> builds + publishes :latest
-#   * push of a version tag   -> builds + publishes :vX.Y.Z and :latest
+#   * push to main            -> builds + publishes immutable :sha-<revision>
+#   * push of a version tag   -> builds + publishes :vX.Y.Z and :sha-<revision>
 #   * manual dispatch         -> builds without pushing (dry-run)
 #
 # Required repository secrets:
-#   * DOCKERHUB_USERNAME  — Docker Hub account with push rights to evoapicloud
-#   * DOCKERHUB_TOKEN     — access token (Settings → Security → New Access Token)
+#   * DOCKERHUB_USERNAME — Docker Hub account name
+#   * DOCKERHUB_TOKEN — Docker Hub access token with write access
 on:
   push:
     branches: [main]
@@ -28,29 +28,37 @@ env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true'
 
 jobs:
-  build-and-push:
-    name: Build & push ${{ matrix.image }}
-    runs-on: ubuntu-latest
+  build:
+    name: Build ${{ matrix.image }} (${{ matrix.platform }})
+    runs-on: ${{ matrix.runner }}
     permissions:
       contents: read
+      packages: write
     strategy:
       fail-fast: false
       matrix:
         include:
           - image: evo-nexus-runtime
             dockerfile: Dockerfile.swarm
+            platform: linux/amd64
+            runner: ubuntu-latest
+          - image: evo-nexus-runtime
+            dockerfile: Dockerfile.swarm
+            platform: linux/arm64
+            runner: ubuntu-24.04-arm
+          - image: evo-nexus-dashboard
+            dockerfile: Dockerfile.swarm.dashboard
+            platform: linux/amd64
+            runner: ubuntu-latest
           - image: evo-nexus-dashboard
             dockerfile: Dockerfile.swarm.dashboard
+            platform: linux/arm64
+            runner: ubuntu-24.04-arm
 
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Set up QEMU (for arm64 emulation on amd64 runners)
-        uses: docker/setup-qemu-action@v3
-        with:
-          platforms: arm64
-
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
@@ -67,26 +75,92 @@ jobs:
         uses: docker/metadata-action@v5
         with:
           images: ${{ env.REGISTRY }}/${{ env.NAMESPACE }}/${{ matrix.image }}
-          # Boa prática: publicar :latest junto com a tag versionada sempre
-          # que um release (tag v*) for empurrado. Push para a branch main
-          # sem tag também atualiza :latest.
-          flavor: |
-            latest=${{ github.ref_type == 'tag' || github.ref == 'refs/heads/main' }}
           tags: |
             type=ref,event=branch
             type=ref,event=tag
             type=semver,pattern={{version}}
             type=semver,pattern={{major}}.{{minor}}
             type=sha,prefix=sha-,format=short
 
-      - name: Build and push
+      - name: Build and push by digest
+        id: build
         uses: docker/build-push-action@v5
         with:
           context: .
           file: ${{ matrix.dockerfile }}
-          platforms: linux/amd64,linux/arm64
+          platforms: ${{ matrix.platform }}
           push: ${{ github.event_name != 'workflow_dispatch' }}
-          tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
-          cache-from: type=gha,scope=${{ matrix.image }}
-          cache-to: type=gha,scope=${{ matrix.image }},mode=max
+          outputs: type=image,name=${{ env.REGISTRY }}/${{ env.NAMESPACE }}/${{ matrix.image }},push-by-digest=true,name-canonical=true,push=${{ github.event_name != 'workflow_dispatch' }}
+          cache-from: type=gha,scope=${{ matrix.image }}-${{ matrix.platform }}
+          cache-to: type=gha,scope=${{ matrix.image }}-${{ matrix.platform }},mode=max
+
+      - name: Export digest
+        if: github.event_name != 'workflow_dispatch'
+        run: |
+          mkdir -p /tmp/digests
+          digest="${{ steps.build.outputs.digest }}"
+          touch "/tmp/digests/${digest#sha256:}"
+
+      - name: Upload digest
+        if: github.event_name != 'workflow_dispatch'
+        uses: actions/upload-artifact@v4
+        with:
+          name: digests-${{ matrix.image }}-${{ matrix.platform == 'linux/amd64' && 'amd64' || 'arm64' }}
+          path: /tmp/digests/*
+          if-no-files-found: error
+          retention-days: 1
+
+  merge:
+    name: Merge manifests (${{ matrix.image }})
+    runs-on: ubuntu-latest
+    if: github.event_name != 'workflow_dispatch'
+    needs: build
+    permissions:
+      contents: read
+      packages: write
+    strategy:
+      matrix:
+        image:
+          - evo-nexus-runtime
+          - evo-nexus-dashboard
+
+    steps:
+      - name: Download digests
+        uses: actions/download-artifact@v4
+        with:
+          path: /tmp/digests
+          pattern: digests-${{ matrix.image }}-*
+          merge-multiple: true
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.NAMESPACE }}/${{ matrix.image }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=tag
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha,prefix=sha-,format=short
+
+      - name: Create manifest list and push
+        working-directory: /tmp/digests
+        run: |
+          docker buildx imagetools create $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
+            $(printf '${{ env.REGISTRY }}/${{ env.NAMESPACE }}/${{ matrix.image }}@sha256:%s ' *)
+
+      - name: Inspect image
+        run: |
+          docker buildx imagetools inspect ${{ env.REGISTRY }}/${{ env.NAMESPACE }}/${{ matrix.image }}:${{ steps.meta.outputs.version }}

.gitignore

@@ -45,6 +45,7 @@ ADWs/routines/custom/
 
 # ── Provider config (user-specific, has API keys) ─
 config/providers.json
+config/hermes_profiles.json
 
 # ── Runtime data & logs ───────────────────
 backups/
@@ -90,6 +91,7 @@ config/routines.yaml
 config/triggers.yaml
 config/heartbeats.yaml
 config/smart-router.json
+config/runtime_policy.json
 
 # ── Claude Code session data ─────────────
 .claude/projects/