From 2bdcd02fb4627769c1fe6d8a625d2ffb2ccb8021 Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 21:58:28 -0300
Subject: [PATCH 01/14] Create release.yml
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fluxo completo (developer experience)
Desenvolva localmente → commit.
Git tag v1.0.0 → push.
GitHub Actions dispara → TODAS as lojas são atualizadas em < 15 min.
GitHub Release criada com AppImage, deb, exe, dmg.
Dry-run? Abra PR com tag v0-dry → pipeline roda sem publicar (usa if: github.event.ref != 'refs/tags/v0-dry').
🔐 Segredos a cadastrar (Settings → Secrets)
Table
Copy
Segredo	Conteúdo (base64 quando .pfx/.p12)
GOOGLE_PLAY_SA_JSON	service-account JSON Google Play
ANDROID_KEYSTORE_PWD	senha do keystore
ANDROID_KEY_ALIAS	alias do cert
ANDROID_KEY_PWD	senha da chave
FASTLANE_PASSWORD	Apple ID senha
FASTLANE_SESSION	Apple 2FA session
MATCH_PASSWORD	passphrase do repositório de certificados
WINDOWS_PFX_BASE64	certificado EV Windows (.pfx)
WINDOWS_CERT_PWD	senha do certificado
MAC_CERT_BASE64	Developer ID Application (.p12)
MAC_CERT_PWD	senha do cert macOS
🚀 Resultado
1 git push origin v1.0.0 →
✅ Google Play (produção)
✅ TestFlight (iOS)
✅ Windows Store (MSIX assinado)
✅ Snapcraft (edge → stable)
✅ GitHub Release (AppImage, deb, dmg, exe)
Ciclo completo de desenvolvimento → lojas em 1 push.
---
 .github/workflows/release/release.yml | 78 +++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 .github/workflows/release/release.yml

diff --git a/.github/workflows/release/release.yml b/.github/workflows/release/release.yml
new file mode 100644
index 00000000..324337b6
--- /dev/null
+++ b/.github/workflows/release/release.yml
@@ -0,0 +1,78 @@
+name: Release Ultimate 3.0
+
+on:
+  push:
+    tags: [ "v*" ]
+
+env:
+  # ----- Android -----
+  ANDROID_KEYSTORE_PWD: ${{ secrets.ANDROID_KEYSTORE_PWD }}
+  ANDROID_KEY_ALIAS:    ${{ secrets.ANDROID_KEY_ALIAS }}
+  ANDROID_KEY_PWD:      ${{ secrets.ANDROID_KEY_PWD }}
+  # ----- iOS (Fastlane Match) -----
+  FASTLANE_PASSWORD:    ${{ secrets.FASTLANE_PASSWORD }}
+  FASTLANE_SESSION:     ${{ secrets.FASTLANE_SESSION }}
+  MATCH_PASSWORD:       ${{ secrets.MATCH_PASSWORD }}
+  # ----- Windows -----
+  WINDOWS_CERT:         ${{ secrets.WINDOWS_PFX_BASE64 }}
+  WINDOWS_CERT_PWD:     ${{ secrets.WINDOWS_CERT_PWD }}
+  # ----- GitHub -----
+  GH_TOKEN:             ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+
+  android:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20 }
+      - run: npm i -g @bubblewrap/cli
+      - run: |
+          npx bubblewrap init --manifest https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/index.html --appName AGI --packageId app.portela.agi --outputDir android --yes
+          npx bubblewrap build --outputDir android
+      - uses: r0adkll/upload-google-play@v1
+        with:
+          serviceAccountJsonPlain: ${{ secrets.GOOGLE_PLAY_SA_JSON }}
+          packageName: app.portela.agi
+          releaseFiles: android/app-release-signed.aab
+          track: production
+
+  ios:
+    runs-on: macos-14
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20 }
+      - run: npm i -g fastlane
+      - run: fastlane ios build_and_upload_testflight
+        working-directory: ios
+
+  electron:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20 }
+      - run: npm ci
+      # Assinatura Windows
+      - if: runner.os == 'Windows'
+        run: |
+          echo %WINDOWS_CERT% | base64 -d > cert.pfx
+          npm i -g electron-builder
+          npx electron-builder -w --publish always -c.win.certificateFile=cert.pfx -c.win.certificatePassword=%WINDOWS_CERT_PWD%
+      # Assinatura macOS
+      - if: runner.os == 'macOS'
+        run: |
+          npm i -g electron-builder
+          CSC_LINK=${{ secrets.MAC_CERT_BASE64 }} CSC_KEY_PASSWORD=${{ secrets.MAC_CERT_PWD }} \
+          npx electron-builder -m --publish always
+      # Linux (Snap + AppImage + deb)
+      - if: runner.os == 'Linux'
+        run: |
+          sudo snap install snapcraft --classic
+          npm i -g electron-builder
+          npx electron-builder -l --publish always

From 4c8cf723faffabb433d4f66da22e7fbdbbc12135 Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:18:51 -0300
Subject: [PATCH 02/14] Create deploy-docs.sh

---
 deploy-docs.sh | 69 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 deploy-docs.sh

diff --git a/deploy-docs.sh b/deploy-docs.sh
new file mode 100644
index 00000000..f7ef073e
--- /dev/null
+++ b/deploy-docs.sh
@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# --------------------------------------------------------------------------
+#  Docsify Auto-Deploy  –  PowerShell & Bash  –  https://github.com/uniaolives/agi
+#  Uso:  bash deploy-docs-unified  ou  pwsh -File deploy-docs-unified.ps1
+# --------------------------------------------------------------------------
+set -euo pipefail
+##############  BASH SECTION  ###############################################
+if [ -n "${BASH_VERSION:-}" ]; then
+LOG_FILE="deploy-log-$(date +%F_%H-%M-%S).txt"
+echo "🚀 Iniciando deploy Docsify (Bash)" | tee -a "$LOG_FILE"
+
+# Detecta branch
+BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
+echo "✅ Branch detectada: $BRANCH" | tee -a "$LOG_FILE"
+
+# Stash / checkout / add
+git stash push -m "Pre-deploy stash" &>>"$LOG_FILE" || true
+git checkout "$BRANCH" &>>"$LOG_FILE"
+
+git add docs/
+if git diff --cached --quiet; then
+  echo "ℹ️  Sem mudanças para enviar." | tee -a "$LOG_FILE"
+  exit 0
+fi
+
+# Dry-run
+if [[ "${1:-}" == "--dry-run" ]]; then
+  echo "🔍 DryRun ativado — nenhuma alteração será enviada." | tee -a "$LOG_FILE"
+  git diff --cached | tee -a "$LOG_FILE"
+  exit 0
+fi
+
+# Commit + push
+git commit -m "docs: auto-deploy $(date '+%Y-%m-%d %H:%M:%S')" &>>"$LOG_FILE"
+git push origin "$BRANCH" &>>"$LOG_FILE"
+
+echo "✅ Deploy concluído! Logs em: $LOG_FILE"
+exit 0
+fi
+##############  POWERSHELL SECTION  #########################################
+if ($PSCommandPath) {
+$logFile = "deploy-log-$(Get-Date -Format 'yyyy-MM-dd_HH-mm-ss').txt"
+Write-Host "🚀 Iniciando deploy Docsify (PowerShell)" -ForegroundColor Cyan
+
+$branch = git rev-parse --abbrev-ref HEAD 2>$null
+if (-not $branch) { $branch = "main" }
+Write-Host "✅ Branch detectada: $branch" -ForegroundColor Green
+
+git stash push -m "Pre-deploy stash" | Out-File -Append $logFile
+git checkout $branch | Out-File -Append $logFile
+
+git add docs/
+if ((git diff --cached --quiet) -eq 0) {
+  Write-Host "ℹ️  Sem mudanças para enviar." -ForegroundColor Yellow
+  exit 0
+}
+
+if ($args[0] -eq "--dry-run") {
+  Write-Host "🔍 DryRun ativado — nenhuma alteração será enviada." -ForegroundColor Magenta
+  git diff --cached | Tee-Object -FilePath $logFile
+  exit 0
+}
+
+git commit -m "docs: auto-deploy $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')" | Out-File -Append $logFile
+git push origin $branch | Out-File -Append $logFile
+
+Write-Host "✅ Deploy concluído! Logs em: $logFile" -ForegroundColor Green
+exit 0
+}

From 79f2b1b5f8b0aee6085558fe657729e82b7e9ab9 Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:19:07 -0300
Subject: [PATCH 03/14] Create deploy-docs.ps1

---
 deploy-docs.ps1 | 69 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 deploy-docs.ps1

diff --git a/deploy-docs.ps1 b/deploy-docs.ps1
new file mode 100644
index 00000000..f7ef073e
--- /dev/null
+++ b/deploy-docs.ps1
@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# --------------------------------------------------------------------------
+#  Docsify Auto-Deploy  –  PowerShell & Bash  –  https://github.com/uniaolives/agi
+#  Uso:  bash deploy-docs-unified  ou  pwsh -File deploy-docs-unified.ps1
+# --------------------------------------------------------------------------
+set -euo pipefail
+##############  BASH SECTION  ###############################################
+if [ -n "${BASH_VERSION:-}" ]; then
+LOG_FILE="deploy-log-$(date +%F_%H-%M-%S).txt"
+echo "🚀 Iniciando deploy Docsify (Bash)" | tee -a "$LOG_FILE"
+
+# Detecta branch
+BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
+echo "✅ Branch detectada: $BRANCH" | tee -a "$LOG_FILE"
+
+# Stash / checkout / add
+git stash push -m "Pre-deploy stash" &>>"$LOG_FILE" || true
+git checkout "$BRANCH" &>>"$LOG_FILE"
+
+git add docs/
+if git diff --cached --quiet; then
+  echo "ℹ️  Sem mudanças para enviar." | tee -a "$LOG_FILE"
+  exit 0
+fi
+
+# Dry-run
+if [[ "${1:-}" == "--dry-run" ]]; then
+  echo "🔍 DryRun ativado — nenhuma alteração será enviada." | tee -a "$LOG_FILE"
+  git diff --cached | tee -a "$LOG_FILE"
+  exit 0
+fi
+
+# Commit + push
+git commit -m "docs: auto-deploy $(date '+%Y-%m-%d %H:%M:%S')" &>>"$LOG_FILE"
+git push origin "$BRANCH" &>>"$LOG_FILE"
+
+echo "✅ Deploy concluído! Logs em: $LOG_FILE"
+exit 0
+fi
+##############  POWERSHELL SECTION  #########################################
+if ($PSCommandPath) {
+$logFile = "deploy-log-$(Get-Date -Format 'yyyy-MM-dd_HH-mm-ss').txt"
+Write-Host "🚀 Iniciando deploy Docsify (PowerShell)" -ForegroundColor Cyan
+
+$branch = git rev-parse --abbrev-ref HEAD 2>$null
+if (-not $branch) { $branch = "main" }
+Write-Host "✅ Branch detectada: $branch" -ForegroundColor Green
+
+git stash push -m "Pre-deploy stash" | Out-File -Append $logFile
+git checkout $branch | Out-File -Append $logFile
+
+git add docs/
+if ((git diff --cached --quiet) -eq 0) {
+  Write-Host "ℹ️  Sem mudanças para enviar." -ForegroundColor Yellow
+  exit 0
+}
+
+if ($args[0] -eq "--dry-run") {
+  Write-Host "🔍 DryRun ativado — nenhuma alteração será enviada." -ForegroundColor Magenta
+  git diff --cached | Tee-Object -FilePath $logFile
+  exit 0
+}
+
+git commit -m "docs: auto-deploy $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')" | Out-File -Append $logFile
+git push origin $branch | Out-File -Append $logFile
+
+Write-Host "✅ Deploy concluído! Logs em: $logFile" -ForegroundColor Green
+exit 0
+}

From bfd3d5b900d1db2e79f67e24e7eefbd5834c3dcb Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:23:30 -0300
Subject: [PATCH 04/14] Update release.yml

---
 .github/workflows/release/release.yml | 324 +++++++++++++++++++++-----
 1 file changed, 264 insertions(+), 60 deletions(-)

diff --git a/.github/workflows/release/release.yml b/.github/workflows/release/release.yml
index 324337b6..9b97fd5a 100644
--- a/.github/workflows/release/release.yml
+++ b/.github/workflows/release/release.yml
@@ -1,78 +1,282 @@
-name: Release Ultimate 3.0
+# .github/workflows/release.yml
+# Release workflow multi-plataforma.
+# - dispara apenas em tags vX.Y.Z (ex.: v1.2.3)
+# - suporta dispatch manual (com opção dry_run)
+# - concurrency para evitar execuções paralelas na mesma tag
+# - jobs: build (linux/windows/macos), android, release
+#
+# SECRETS NEEDED (configure no repo Settings → Secrets):
+# - ANDROID_KEYSTORE_BASE64
+# - ANDROID_KEYSTORE_PASSWORD
+# - ANDROID_KEY_ALIAS
+# - GOOGLE_PLAY_SERVICE_ACCOUNT_JSON (base64 or raw JSON)
+# - MAC_CERT_P12_BASE64
+# - MAC_CERT_PASSWORD
+# - WINDOWS_SIGNING_CERT_BASE64
+# - WINDOWS_CERT_PASSWORD
+# - GPG_SIGNING_KEY (optional)
+# - SLACK_WEBHOOK (optional notification)
+#
+name: Release — AGI
 
 on:
   push:
-    tags: [ "v*" ]
+    tags:
+      - 'v*.*.*'           # only run on semver-like tags
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag to release (overrides $GITHUB_REF)'
+        required: false
+      dry_run:
+        type: boolean
+        description: 'If true, simulate the release (no publish)'
+        default: false
+
+concurrency:
+  group: release-${{ github.ref_name || github.event.inputs.tag || github.sha }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write     # needed to create releases and upload assets
+  packages: write
 
 env:
-  # ----- Android -----
-  ANDROID_KEYSTORE_PWD: ${{ secrets.ANDROID_KEYSTORE_PWD }}
-  ANDROID_KEY_ALIAS:    ${{ secrets.ANDROID_KEY_ALIAS }}
-  ANDROID_KEY_PWD:      ${{ secrets.ANDROID_KEY_PWD }}
-  # ----- iOS (Fastlane Match) -----
-  FASTLANE_PASSWORD:    ${{ secrets.FASTLANE_PASSWORD }}
-  FASTLANE_SESSION:     ${{ secrets.FASTLANE_SESSION }}
-  MATCH_PASSWORD:       ${{ secrets.MATCH_PASSWORD }}
-  # ----- Windows -----
-  WINDOWS_CERT:         ${{ secrets.WINDOWS_PFX_BASE64 }}
-  WINDOWS_CERT_PWD:     ${{ secrets.WINDOWS_CERT_PWD }}
-  # ----- GitHub -----
-  GH_TOKEN:             ${{ secrets.GITHUB_TOKEN }}
+  RELEASE_DIR: release
+  ARTIFACT_NAMESPACE: agi
 
 jobs:
-
-  android:
+  # Basic sanity & checkout (runs fast, always on ubuntu)
+  prepare:
     runs-on: ubuntu-latest
+    outputs:
+      tag_name: ${{ steps.get-tag.outputs.tag }}
+      is_dry_run: ${{ steps.get-tag.outputs.dry_run }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with: { node-version: 20 }
-      - run: npm i -g @bubblewrap/cli
-      - run: |
-          npx bubblewrap init --manifest https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}/index.html --appName AGI --packageId app.portela.agi --outputDir android --yes
-          npx bubblewrap build --outputDir android
-      - uses: r0adkll/upload-google-play@v1
+      - name: Checkout
+        uses: actions/checkout@v4
         with:
-          serviceAccountJsonPlain: ${{ secrets.GOOGLE_PLAY_SA_JSON }}
-          packageName: app.portela.agi
-          releaseFiles: android/app-release-signed.aab
-          track: production
+          fetch-depth: 0
 
-  ios:
-    runs-on: macos-14
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with: { node-version: 20 }
-      - run: npm i -g fastlane
-      - run: fastlane ios build_and_upload_testflight
-        working-directory: ios
-
-  electron:
+      - name: Determine tag and dry_run
+        id: get-tag
+        shell: bash
+        run: |
+          # prefer explicitly provided tag input, else use GITHUB_REF_NAME
+          INPUT_TAG="${{ github.event.inputs.tag }}"
+          REF_TAG="${GITHUB_REF_NAME:-}"
+          TAG="${INPUT_TAG:-${REF_TAG}}"
+          if [[ -z "$TAG" ]]; then
+            echo "No tag supplied and not pushed from tag ref. Exiting (use workflow_dispatch with tag to test)."
+            echo "tag="
+            echo "dry_run=true"
+            # export outputs empty to indicate we should not continue with build
+            echo "::set-output name=tag::"
+            echo "::set-output name=dry_run::true"
+            exit 0
+          fi
+          # Normalize: strip refs/heads/ etc.
+          echo "Resolved tag: $TAG"
+          # Pass dry_run flag if input set
+          DRY="${{ github.event.inputs.dry_run }}"
+          echo "::set-output name=tag::$TAG"
+          echo "::set-output name=dry_run::$DRY"
+
+  # Build job matrix for desktop platforms
+  build:
+    needs: prepare
+    if: needs.prepare.outputs.tag_name != ''  # only proceed if tag present
+    runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-    runs-on: ${{ matrix.os }}
+    env:
+      TAG: ${{ needs.prepare.outputs.tag_name }}
+      RELEASE_DIR: ${{ env.RELEASE_DIR }}
+      PLATFORM: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with: { node-version: 20 }
-      - run: npm ci
-      # Assinatura Windows
-      - if: runner.os == 'Windows'
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'yarn'
+
+      - name: Install dependencies
         run: |
-          echo %WINDOWS_CERT% | base64 -d > cert.pfx
-          npm i -g electron-builder
-          npx electron-builder -w --publish always -c.win.certificateFile=cert.pfx -c.win.certificatePassword=%WINDOWS_CERT_PWD%
-      # Assinatura macOS
-      - if: runner.os == 'macOS'
+          yarn install --frozen-lockfile
+
+      - name: Run platform build script
+        shell: bash
         run: |
-          npm i -g electron-builder
-          CSC_LINK=${{ secrets.MAC_CERT_BASE64 }} CSC_KEY_PASSWORD=${{ secrets.MAC_CERT_PWD }} \
-          npx electron-builder -m --publish always
-      # Linux (Snap + AppImage + deb)
-      - if: runner.os == 'Linux'
+          # adapt these commands to your real build scripts
+          mkdir -p $RELEASE_DIR/${{ matrix.os }}
+          if [[ "${{ matrix.os }}" == "ubuntu-latest" ]]; then
+            # Linux: build AppImage / deb / rpm
+            ./build-agi.sh || true
+            # ensure artifacts exist (adjust names to your build)
+            # e.g. cp dist/AGI.AppImage $RELEASE_DIR/linux/ || true
+          elif [[ "${{ matrix.os }}" == "macos-latest" ]]; then
+            # Mac: build .app / dmg
+            ./build-agi.sh || true
+            # e.g. cp -r dist/AGI.app $RELEASE_DIR/darwin/ || true
+          else
+            # Windows: build exe (run via bash remainder in Windows runner uses bash on mingw)
+            ./build-agi.sh || true
+            # e.g. cp dist/AGI.exe $RELEASE_DIR/win/ || true
+          fi
+
+      - name: Collect artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ env.ARTIFACT_NAMESPACE }}-desktop-${{ matrix.os }}
+          path: |
+            ${{ env.RELEASE_DIR }}/*
+
+  # Android build (separate because it requires keystore & Google Play secrets)
+  android:
+    needs: prepare
+    if: needs.prepare.outputs.tag_name != ''
+    runs-on: ubuntu-latest
+    env:
+      TAG: ${{ needs.prepare.outputs.tag_name }}
+      RELEASE_DIR: ${{ env.RELEASE_DIR }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Install deps
+        run: yarn install --frozen-lockfile
+
+      - name: Setup Android credentials (keystore from secret)
+        if: secrets.ANDROID_KEYSTORE_BASE64 != ''
+        run: |
+          echo "Restoring Android keystore..."
+          echo "${ANDROID_KEYSTORE_BASE64}" | base64 --decode > android.keystore
+          # export keystore path env vars for bubblewrap or gradle
+          echo "ANDROID_KEYSTORE_PATH=$(pwd)/android.keystore" >> $GITHUB_ENV
+          echo "ANDROID_KEYSTORE_PASSWORD=${ANDROID_KEYSTORE_PASSWORD}" >> $GITHUB_ENV
+          echo "ANDROID_KEY_ALIAS=${ANDROID_KEY_ALIAS}" >> $GITHUB_ENV
+
+      - name: Build Android (Bubblewrap or your build)
+        run: |
+          # Example using bubblewrap if your project is PWA self-contained
+          npm i -g @bubblewrap/cli
+          npx @bubblewrap/cli init --manifest "https://url.curta/index.html" --appName "AGI" --packageId "app.portela.agi" --outputDir "$RELEASE_DIR/android" --yes || true
+          npx @bubblewrap/cli build --outputDir "$RELEASE_DIR/android" || true
+        env:
+          ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
+          ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+
+      - name: Upload Android artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ env.ARTIFACT_NAMESPACE }}-android
+          path: ${{ env.RELEASE_DIR }}/android
+
+  # Create GitHub Release and upload artifacts
+  release:
+    needs: [build, android]
+    if: needs.prepare.outputs.tag_name != ''
+    runs-on: ubuntu-latest
+    env:
+      TAG: ${{ needs.prepare.outputs.tag_name }}
+      DRY_RUN: ${{ needs.prepare.outputs.dry_run }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download desktop artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: |
+            ${{ env.ARTIFACT_NAMESPACE }}-desktop-ubuntu-latest
+            ${{ env.ARTIFACT_NAMESPACE }}-desktop-windows-latest
+            ${{ env.ARTIFACT_NAMESPACE }}-desktop-macos-latest
+            ${{ env.ARTIFACT_NAMESPACE }}-android
+          path: ./artifacts || true
+
+      - name: List artifacts (debug)
+        run: |
+          echo "=== Artifacts ==="
+          ls -R artifacts || true
+
+      - name: Prepare release notes
+        id: notes
+        run: |
+          # generate simple release notes from commits included in the tag
+          TAG="${TAG}"
+          # try to build release notes; fallback to basic message
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            NOTES=$(git log --pretty=format:'- %s (%h)' ${TAG}^..! || echo "Automated release ${TAG}")
+          else
+            NOTES="Automated release ${TAG}"
+          fi
+          echo "notes<<EOF" >> $GITHUB_OUTPUT
+          echo "$NOTES" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create or update GitHub Release
+        if: ${{ env.DRY_RUN != 'true' }}
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ env.TAG }}
+          name: ${{ env.TAG }}
+          body: ${{ steps.notes.outputs.notes }}
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload assets to GitHub Release
+        if: ${{ env.DRY_RUN != 'true' }}
+        run: |
+          set -e
+          # find artifacts and upload using gh (GitHub CLI) if available
+          # prefer GH CLI for uploading; fallback to curl+API if not available
+          if command -v gh >/dev/null 2>&1; then
+            gh release upload "${TAG}" artifacts/* --clobber || true
+          else
+            echo "gh CLI not available; uploading via API..."
+            for file in artifacts/*; do
+              [ -f "$file" ] || continue
+              NAME=$(basename "$file")
+              echo "Uploading $file"
+              UPLOAD_URL=$(jq -r .upload_url < <(gh api repos/${{ github.repository }}/releases/tags/${TAG} 2>/dev/null) | sed -e "s/{?name,label}//")
+              if [ -z "$UPLOAD_URL" ]; then
+                echo "Could not obtain upload url; skipping $file"
+                continue
+              fi
+              curl -s -X POST -H "Authorization: token ${GITHUB_TOKEN}" -H "Content-Type: application/octet-stream" --data-binary @"$file" "$UPLOAD_URL?name=$NAME"
+            done
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Notify (optional Slack)
+        if: ${{ secrets.SLACK_WEBHOOK != '' }}
+        run: |
+          echo "Sending Slack notification..."
+          PAYLOAD=$(jq -n --arg tag "${TAG}" --arg repo "${{ github.repository }}" '{text: ("Release " + $tag + " published for " + $repo)}')
+          curl -s -X POST -H 'Content-type: application/json' --data "$PAYLOAD" "${{ secrets.SLACK_WEBHOOK }}"
+
+      - name: Dry-run summary
+        if: ${{ env.DRY_RUN == 'true' }}
         run: |
-          sudo snap install snapcraft --classic
-          npm i -g electron-builder
-          npx electron-builder -l --publish always
+          echo "== Dry-run mode: release not published =="
+          ls -R artifacts || true

From 19588c697eee23e233d0ddea22d21d11ff5dd48b Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:26:15 -0300
Subject: [PATCH 05/14] Update release.yml

---
 .github/workflows/release/release.yml | 285 ++++++--------------------
 1 file changed, 59 insertions(+), 226 deletions(-)

diff --git a/.github/workflows/release/release.yml b/.github/workflows/release/release.yml
index 9b97fd5a..a8c2e609 100644
--- a/.github/workflows/release/release.yml
+++ b/.github/workflows/release/release.yml
@@ -1,282 +1,115 @@
-# .github/workflows/release.yml
-# Release workflow multi-plataforma.
-# - dispara apenas em tags vX.Y.Z (ex.: v1.2.3)
-# - suporta dispatch manual (com opção dry_run)
-# - concurrency para evitar execuções paralelas na mesma tag
-# - jobs: build (linux/windows/macos), android, release
-#
-# SECRETS NEEDED (configure no repo Settings → Secrets):
-# - ANDROID_KEYSTORE_BASE64
-# - ANDROID_KEYSTORE_PASSWORD
-# - ANDROID_KEY_ALIAS
-# - GOOGLE_PLAY_SERVICE_ACCOUNT_JSON (base64 or raw JSON)
-# - MAC_CERT_P12_BASE64
-# - MAC_CERT_PASSWORD
-# - WINDOWS_SIGNING_CERT_BASE64
-# - WINDOWS_CERT_PASSWORD
-# - GPG_SIGNING_KEY (optional)
-# - SLACK_WEBHOOK (optional notification)
-#
-name: Release — AGI
+name: 🚀 AGI Multiplatform Release
 
 on:
   push:
     tags:
-      - 'v*.*.*'           # only run on semver-like tags
+      - "v*"
   workflow_dispatch:
     inputs:
-      tag:
-        description: 'Tag to release (overrides $GITHUB_REF)'
+      version:
+        description: "Versão manual (ex: v0.91)"
         required: false
-      dry_run:
-        type: boolean
-        description: 'If true, simulate the release (no publish)'
-        default: false
-
-concurrency:
-  group: release-${{ github.ref_name || github.event.inputs.tag || github.sha }}
-  cancel-in-progress: true
 
 permissions:
-  contents: write     # needed to create releases and upload assets
-  packages: write
+  contents: write
 
 env:
+  NODE_VERSION: 20
   RELEASE_DIR: release
-  ARTIFACT_NAMESPACE: agi
 
 jobs:
-  # Basic sanity & checkout (runs fast, always on ubuntu)
-  prepare:
-    runs-on: ubuntu-latest
-    outputs:
-      tag_name: ${{ steps.get-tag.outputs.tag }}
-      is_dry_run: ${{ steps.get-tag.outputs.dry_run }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Determine tag and dry_run
-        id: get-tag
-        shell: bash
-        run: |
-          # prefer explicitly provided tag input, else use GITHUB_REF_NAME
-          INPUT_TAG="${{ github.event.inputs.tag }}"
-          REF_TAG="${GITHUB_REF_NAME:-}"
-          TAG="${INPUT_TAG:-${REF_TAG}}"
-          if [[ -z "$TAG" ]]; then
-            echo "No tag supplied and not pushed from tag ref. Exiting (use workflow_dispatch with tag to test)."
-            echo "tag="
-            echo "dry_run=true"
-            # export outputs empty to indicate we should not continue with build
-            echo "::set-output name=tag::"
-            echo "::set-output name=dry_run::true"
-            exit 0
-          fi
-          # Normalize: strip refs/heads/ etc.
-          echo "Resolved tag: $TAG"
-          # Pass dry_run flag if input set
-          DRY="${{ github.event.inputs.dry_run }}"
-          echo "::set-output name=tag::$TAG"
-          echo "::set-output name=dry_run::$DRY"
-
-  # Build job matrix for desktop platforms
   build:
-    needs: prepare
-    if: needs.prepare.outputs.tag_name != ''  # only proceed if tag present
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
     strategy:
-      fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
-    env:
-      TAG: ${{ needs.prepare.outputs.tag_name }}
-      RELEASE_DIR: ${{ env.RELEASE_DIR }}
-      PLATFORM: ${{ matrix.os }}
+        os: [windows-latest, ubuntu-latest, macos-latest]
+    name: Build ${{ matrix.os }}
     steps:
-      - name: Checkout
+      - name: 🧩 Checkout
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
-      - name: Setup Node.js
+      - name: ⚙️ Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20.x'
-          cache: 'yarn'
+          node-version: ${{ env.NODE_VERSION }}
+          cache: yarn
 
-      - name: Install dependencies
-        run: |
-          yarn install --frozen-lockfile
+      - name: 📦 Install dependencies
+        run: yarn install --frozen-lockfile
 
-      - name: Run platform build script
-        shell: bash
+      - name: 🏗️ Build AGI for ${{ matrix.os }}
         run: |
-          # adapt these commands to your real build scripts
-          mkdir -p $RELEASE_DIR/${{ matrix.os }}
-          if [[ "${{ matrix.os }}" == "ubuntu-latest" ]]; then
-            # Linux: build AppImage / deb / rpm
-            ./build-agi.sh || true
-            # ensure artifacts exist (adjust names to your build)
-            # e.g. cp dist/AGI.AppImage $RELEASE_DIR/linux/ || true
-          elif [[ "${{ matrix.os }}" == "macos-latest" ]]; then
-            # Mac: build .app / dmg
-            ./build-agi.sh || true
-            # e.g. cp -r dist/AGI.app $RELEASE_DIR/darwin/ || true
-          else
-            # Windows: build exe (run via bash remainder in Windows runner uses bash on mingw)
-            ./build-agi.sh || true
-            # e.g. cp dist/AGI.exe $RELEASE_DIR/win/ || true
-          fi
+          mkdir -p $RELEASE_DIR
+          yarn build
 
-      - name: Collect artifacts
-        if: always()
+      - name: 📁 Upload artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.ARTIFACT_NAMESPACE }}-desktop-${{ matrix.os }}
-          path: |
-            ${{ env.RELEASE_DIR }}/*
+          name: agi-${{ matrix.os }}
+          path: ${{ env.RELEASE_DIR }}/
 
-  # Android build (separate because it requires keystore & Google Play secrets)
   android:
-    needs: prepare
-    if: needs.prepare.outputs.tag_name != ''
     runs-on: ubuntu-latest
-    env:
-      TAG: ${{ needs.prepare.outputs.tag_name }}
-      RELEASE_DIR: ${{ env.RELEASE_DIR }}
+    name: Build Android (Bubblewrap)
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
+      - uses: actions/checkout@v4
 
-      - name: Setup Node.js
+      - name: ⚙️ Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20.x'
-
-      - name: Install deps
-        run: yarn install --frozen-lockfile
+          node-version: ${{ env.NODE_VERSION }}
 
-      - name: Setup Android credentials (keystore from secret)
-        if: secrets.ANDROID_KEYSTORE_BASE64 != ''
-        run: |
-          echo "Restoring Android keystore..."
-          echo "${ANDROID_KEYSTORE_BASE64}" | base64 --decode > android.keystore
-          # export keystore path env vars for bubblewrap or gradle
-          echo "ANDROID_KEYSTORE_PATH=$(pwd)/android.keystore" >> $GITHUB_ENV
-          echo "ANDROID_KEYSTORE_PASSWORD=${ANDROID_KEYSTORE_PASSWORD}" >> $GITHUB_ENV
-          echo "ANDROID_KEY_ALIAS=${ANDROID_KEY_ALIAS}" >> $GITHUB_ENV
+      - name: 📦 Install Bubblewrap
+        run: npm i -g @bubblewrap/cli
 
-      - name: Build Android (Bubblewrap or your build)
+      - name: 📲 Build Android APK/AAB
         run: |
-          # Example using bubblewrap if your project is PWA self-contained
-          npm i -g @bubblewrap/cli
-          npx @bubblewrap/cli init --manifest "https://url.curta/index.html" --appName "AGI" --packageId "app.portela.agi" --outputDir "$RELEASE_DIR/android" --yes || true
-          npx @bubblewrap/cli build --outputDir "$RELEASE_DIR/android" || true
-        env:
-          ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
-          ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+          mkdir -p $RELEASE_DIR
+          yarn build:android
 
-      - name: Upload Android artifact
+      - name: 📁 Upload Android artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: ${{ env.ARTIFACT_NAMESPACE }}-android
-          path: ${{ env.RELEASE_DIR }}/android
+          name: agi-android
+          path: ${{ env.RELEASE_DIR }}/
 
-  # Create GitHub Release and upload artifacts
   release:
-    needs: [build, android]
-    if: needs.prepare.outputs.tag_name != ''
     runs-on: ubuntu-latest
-    env:
-      TAG: ${{ needs.prepare.outputs.tag_name }}
-      DRY_RUN: ${{ needs.prepare.outputs.dry_run }}
+    needs: [build, android]
+    name: 📤 Publish GitHub Release
     steps:
-      - name: Checkout
+      - name: 🧩 Checkout
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
-      - name: Download desktop artifacts
+      - name: 📥 Download all artifacts
         uses: actions/download-artifact@v4
         with:
-          name: |
-            ${{ env.ARTIFACT_NAMESPACE }}-desktop-ubuntu-latest
-            ${{ env.ARTIFACT_NAMESPACE }}-desktop-windows-latest
-            ${{ env.ARTIFACT_NAMESPACE }}-desktop-macos-latest
-            ${{ env.ARTIFACT_NAMESPACE }}-android
-          path: ./artifacts || true
+          path: ${{ env.RELEASE_DIR }}
 
-      - name: List artifacts (debug)
-        run: |
-          echo "=== Artifacts ==="
-          ls -R artifacts || true
+      - name: 🧾 List release contents
+        run: ls -R $RELEASE_DIR
 
-      - name: Prepare release notes
-        id: notes
+      - name: 🏷️ Determine version
+        id: version
         run: |
-          # generate simple release notes from commits included in the tag
-          TAG="${TAG}"
-          # try to build release notes; fallback to basic message
-          if git rev-parse "$TAG" >/dev/null 2>&1; then
-            NOTES=$(git log --pretty=format:'- %s (%h)' ${TAG}^..! || echo "Automated release ${TAG}")
-          else
-            NOTES="Automated release ${TAG}"
-          fi
-          echo "notes<<EOF" >> $GITHUB_OUTPUT
-          echo "$NOTES" >> $GITHUB_OUTPUT
-          echo "EOF" >> $GITHUB_OUTPUT
+          echo "tag=${GITHUB_REF##*/}" >> $GITHUB_OUTPUT
 
-      - name: Create or update GitHub Release
-        if: ${{ env.DRY_RUN != 'true' }}
-        uses: softprops/action-gh-release@v1
+      - name: 🚀 Create GitHub Release
+        uses: softprops/action-gh-release@v2
         with:
-          tag_name: ${{ env.TAG }}
-          name: ${{ env.TAG }}
-          body: ${{ steps.notes.outputs.notes }}
-          draft: false
-          prerelease: false
+          tag_name: ${{ steps.version.outputs.tag }}
+          name: "AGI ${{ steps.version.outputs.tag }}"
+          body: |
+            AGI Release ${{ steps.version.outputs.tag }}
+
+            **Includes:**
+            - Windows `.exe`
+            - Linux `.AppImage` `.deb` `.rpm`
+            - macOS `.app`
+            - Android `.apk` `.aab`
+
+            **Auto-generated by**: GitHub Actions 🚀
+          files: |
+            ${{ env.RELEASE_DIR }}/**/*
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Upload assets to GitHub Release
-        if: ${{ env.DRY_RUN != 'true' }}
-        run: |
-          set -e
-          # find artifacts and upload using gh (GitHub CLI) if available
-          # prefer GH CLI for uploading; fallback to curl+API if not available
-          if command -v gh >/dev/null 2>&1; then
-            gh release upload "${TAG}" artifacts/* --clobber || true
-          else
-            echo "gh CLI not available; uploading via API..."
-            for file in artifacts/*; do
-              [ -f "$file" ] || continue
-              NAME=$(basename "$file")
-              echo "Uploading $file"
-              UPLOAD_URL=$(jq -r .upload_url < <(gh api repos/${{ github.repository }}/releases/tags/${TAG} 2>/dev/null) | sed -e "s/{?name,label}//")
-              if [ -z "$UPLOAD_URL" ]; then
-                echo "Could not obtain upload url; skipping $file"
-                continue
-              fi
-              curl -s -X POST -H "Authorization: token ${GITHUB_TOKEN}" -H "Content-Type: application/octet-stream" --data-binary @"$file" "$UPLOAD_URL?name=$NAME"
-            done
-          fi
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Notify (optional Slack)
-        if: ${{ secrets.SLACK_WEBHOOK != '' }}
-        run: |
-          echo "Sending Slack notification..."
-          PAYLOAD=$(jq -n --arg tag "${TAG}" --arg repo "${{ github.repository }}" '{text: ("Release " + $tag + " published for " + $repo)}')
-          curl -s -X POST -H 'Content-type: application/json' --data "$PAYLOAD" "${{ secrets.SLACK_WEBHOOK }}"
-
-      - name: Dry-run summary
-        if: ${{ env.DRY_RUN == 'true' }}
-        run: |
-          echo "== Dry-run mode: release not published =="
-          ls -R artifacts || true

From e7e8b78da7d00d3a1f27f5213502515676eba2f5 Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:27:43 -0300
Subject: [PATCH 06/14] Create python-publish.yml

---
 .github/workflows/python-publish.yml | 70 ++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 .github/workflows/python-publish.yml

diff --git a/.github/workflows/python-publish.yml b/.github/workflows/python-publish.yml
new file mode 100644
index 00000000..82f8dbd9
--- /dev/null
+++ b/.github/workflows/python-publish.yml
@@ -0,0 +1,70 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          # NOTE: put your own distribution build steps here.
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      # url: https://pypi.org/p/YOURPROJECT
+      #
+      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+      # ALTERNATIVE: exactly, uncomment the following line instead:
+      # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

From 25deaadc439e556a5e52860beb84e80e71ec8409 Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:27:56 -0300
Subject: [PATCH 07/14] Create pylint.yml

---
 .github/workflows/pylint.yml | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 .github/workflows/pylint.yml

diff --git a/.github/workflows/pylint.yml b/.github/workflows/pylint.yml
new file mode 100644
index 00000000..c73e032c
--- /dev/null
+++ b/.github/workflows/pylint.yml
@@ -0,0 +1,23 @@
+name: Pylint
+
+on: [push]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10"]
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pylint
+    - name: Analysing the code with pylint
+      run: |
+        pylint $(git ls-files '*.py')

From d929abe68624692dae480445256ba93491edc43e Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:50:08 -0300
Subject: [PATCH 08/14] Create agi-launcher-universal-v3.sh

---
 agi-launcher-universal-v3.sh | 139 +++++++++++++++++++++++++++++++++++
 1 file changed, 139 insertions(+)
 create mode 100644 agi-launcher-universal-v3.sh

diff --git a/agi-launcher-universal-v3.sh b/agi-launcher-universal-v3.sh
new file mode 100644
index 00000000..9bc3de74
--- /dev/null
+++ b/agi-launcher-universal-v3.sh
@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# --------------------------------------------------------------------------
+#  AGI Universal Launcher v3 – Cross-Platform (Bash/WSL/Git Bash)
+#  Uso: ./agi-launcher-universal-v3.sh [--Path <caminho>] [--Debug] [--DryRun]
+# --------------------------------------------------------------------------
+
+set -euo pipefail
+
+# ---------- config ----------
+LOG_FILE="launcher-log-$(date +%F_%H-%M-%S).txt"
+exec > >(tee -a "$LOG_FILE") 2>&1
+
+DEFAULT_PATHS=(
+    "$HOME/agi-build/agi/release/AGI-win32-x64/AGI.exe"
+    "$HOME/agi-build/agi/release/AGI-linux-x64/AGI.AppImage"
+    "$HOME/agi-build/agi/release/AGI-darwin-x64/AGI.app"
+    "./release/AGI-win32-x64/AGI.exe"
+    "./release/AGI-linux-x64/AGI.AppImage"
+    "./release/AGI-darwin-x64/AGI.app"
+)
+
+# ---------- parse args ----------
+PATH_ARG=""
+DEBUG_FLAG=false
+DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --Path) PATH_ARG="$2"; shift 2 ;;
+        --Debug) DEBUG_FLAG=true; shift ;;
+        --DryRun) DRY_RUN=true; shift ;;
+        --help) echo "Uso: $0 [--Path <caminho>] [--Debug] [--DryRun]"; exit 0 ;;
+        *) echo "Opção desconhecida: $1"; exit 1 ;;
+    esac
+done
+
+# ---------- detect SO ----------
+case "$(uname -s)" in
+    Linux*)     OS="linux" ;;
+    Darwin*)    OS="mac" ;;
+    MINGW*|CYGWIN*|MSYS*) OS="win" ;;
+    *)          OS="unknown" ;;
+esac
+
+# ---------- extensões por SO ----------
+case "$OS" in
+    linux) EXT="AppImage" ;;
+    mac)   EXT="app" ;;
+    win)   EXT="exe" ;;
+    *)     EXT="*" ;;
+esac
+
+# ---------- caminhos candidatos ----------
+if [[ -n "$PATH_ARG" ]]; then
+    if [[ -d "$PATH_ARG" ]]; then
+        CANDIDATES=($(find "$PATH_ARG" -maxdepth 1 -type f -iname "*.$EXT" | head -n 1))
+    else
+        CANDIDATES=("$PATH_ARG")
+    fi
+else
+    CANDIDATES=("${DEFAULT_PATHS[@]}")
+fi
+
+# ---------- funções ----------
+function find_build() {
+    for c in "${CANDIDATES[@]}"; do
+        [[ -f "$c" ]] && echo "$c" && return
+    done
+    return 1
+}
+
+function show_menu() {
+    echo "┌─────────────── AGI Universal Launcher v3 ───────────────┐"
+    echo "│ SO detectado: $OS │ Extensão esperada: *.$EXT │"
+    echo "├─────────────────────────────────────────────────────────┤"
+    echo "│ 1) Executar AGI                                         │"
+    echo "│ 2) Executar com logs (--Debug)                          │"
+    echo "│ 3) Validar ambiente (--DryRun)                          │"
+    echo "│ 0) Sair                                                 │"
+    echo "└─────────────────────────────────────────────────────────┘"
+    read -p "Escolha: " opt
+    case $opt in
+        1) return 0 ;;
+        2) DEBUG_FLAG=true; return 0 ;;
+        3) DRY_RUN=true; return 0 ;;
+        0) exit 0 ;;
+        *) echo "Opção inválida"; exit 1 ;;
+    esac
+}
+
+# ---------- lógica ----------
+if [[ $# -eq 0 ]]; then
+    show_menu
+fi
+
+build=$(find_build)
+if [[ -z "$build" ]]; then
+    echo "❌ Build não encontrado para $OS (*.$EXT)"
+    echo "Caminhos verificados:"
+    printf '  → %s\n' "${CANDIDATES[@]}"
+    exit 1
+fi
+
+if $DRY_RUN; then
+    echo "✅ Build localizado: $build"
+    exit 0
+fi
+
+echo "🚀 Iniciando AGI..."
+case "$EXT" in
+    AppImage)
+        chmod +x "$build" 2>/dev/null
+        if $DEBUG_FLAG; then
+            x-terminal-emulator -e "$build" || gnome-terminal -- "$build" || "$build"
+        else
+            "$build" &
+        fi
+        ;;
+    app)
+        if $DEBUG_FLAG; then
+            open -a "$build"
+        else
+            open "$build"
+        fi
+        ;;
+    exe)
+        if $DEBUG_FLAG; then
+            powershell -NoExit -Command "\"$build\""
+        else
+            cmd /c start "" "$build"
+        fi
+        ;;
+    *)
+        echo "⚠️ Tipo de build desconhecido: $build"
+        exit 1
+        ;;
+esac
+
+echo "✅ Launcher finalizado. Log: $LOG_FILE"

From c748d909f4ec255c9fe0875313f3f9d1074010eb Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:54:13 -0300
Subject: [PATCH 09/14] Create agi-launcher-universal-v3(1).sh

---
 agi-launcher-universal-v3(1).sh | 245 ++++++++++++++++++++++++++++++++
 1 file changed, 245 insertions(+)
 create mode 100644 agi-launcher-universal-v3(1).sh

diff --git a/agi-launcher-universal-v3(1).sh b/agi-launcher-universal-v3(1).sh
new file mode 100644
index 00000000..ee54b6c1
--- /dev/null
+++ b/agi-launcher-universal-v3(1).sh
@@ -0,0 +1,245 @@
+#!/usr/bin/env bash
+# --------------------------------------------------------------------------
+# AGI Universal Launcher v3 – Cross-Platform (Bash/WSL/Git Bash)
+# Uso: ./agi-launcher-universal-v3.sh [--path <caminho>] [--debug] [--dry-run]
+# --------------------------------------------------------------------------
+
+set -euo pipefail
+
+# --- CONFIGURAÇÃO ---
+REPO_DIR="agi"
+BUILD_ROOT="release"
+LOG_FILE="launcher-log-$(date +%Y-%m-%d_%H-%M-%S).txt"
+
+# Variáveis de Argumentos
+CUSTOM_PATH=""
+DEBUG_MODE=0
+DRY_RUN=0
+INTERACTIVE_MENU=1
+
+# --- FUNÇÕES DE UTILIDADE ---
+
+# Função de Log
+log() {
+    echo "[$(date +%H:%M:%S)] $1" | tee -a "$LOG_FILE"
+}
+
+# Função de erro e saída
+die() {
+    log "❌ ERRO: $1"
+    exit 1
+}
+
+# --- PARSING DE ARGUMENTOS ---
+
+parse_args() {
+    log "Analisando argumentos..."
+    
+    # Parâmetros esperados
+    local options
+    options=$(getopt -o "" --long debug,dry-run,path: -- "$@")
+    
+    if [ $? -ne 0 ]; then
+        die "Falha ao analisar argumentos."
+    fi
+
+    eval set -- "$options"
+
+    while true; do
+        case "$1" in
+            --debug)
+                DEBUG_MODE=1
+                log "Modo: DEBUG ativado."
+                shift
+                ;;
+            --dry-run)
+                DRY_RUN=1
+                log "Modo: DRY-RUN ativado (Nenhuma execução real)."
+                INTERACTIVE_MENU=0
+                shift
+                ;;
+            --path)
+                CUSTOM_PATH="$2"
+                log "Caminho customizado definido: $CUSTOM_PATH"
+                shift 2
+                ;;
+            --)
+                shift
+                break
+                ;;
+            *)
+                die "Argumento desconhecido: $1"
+                ;;
+        esac
+    done
+}
+
+# --- DETECÇÃO E RESOLUÇÃO DE CAMINHO ---
+
+detect_platform() {
+    local OS_NAME
+    OS_NAME=$(uname -s)
+    local TARGET_DIR=""
+    local EXTENSION=""
+
+    log "Detectando sistema operacional..."
+
+    case "$OS_NAME" in
+        Linux*)
+            if [[ -n "$WSL_DISTRO_NAME" ]] || [[ "$TERM" == *cygwin* ]]; then
+                log "Ambiente Windows (WSL/Git Bash) detectado."
+                TARGET_DIR="AGI-win32-x64"
+                EXTENSION=".exe"
+                # Se for WSL, usamos o .exe do Windows
+            else
+                log "Ambiente Linux detectado."
+                TARGET_DIR="AGI-linux-x64"
+                EXTENSION=".AppImage"
+            fi
+            ;;
+        Darwin*)
+            log "Ambiente macOS detectado."
+            TARGET_DIR="AGI-darwin-x64"
+            EXTENSION=".app"
+            ;;
+        MINGW*|CYGWIN*)
+            log "Ambiente Windows (Git Bash nativo) detectado."
+            TARGET_DIR="AGI-win32-x64"
+            EXTENSION=".exe"
+            ;;
+        *)
+            die "Sistema operacional não suportado: $OS_NAME"
+            ;;
+    esac
+
+    # Se um caminho customizado foi fornecido, usamos ele
+    if [ -n "$CUSTOM_PATH" ]; then
+        EXECUTABLE_PATH="$CUSTOM_PATH"
+    else
+        # Se não, resolvemos o caminho padrão
+        if [ "$EXTENSION" == ".app" ]; then
+            # No macOS, o .app é uma pasta, e o executável está dentro
+            EXECUTABLE_PATH="$BUILD_ROOT/$TARGET_DIR/AGI.app/Contents/MacOS/AGI"
+            # O usuário pode querer rodar o open, mas para fins de script, rodamos o binário
+        else
+            EXECUTABLE_PATH="$BUILD_ROOT/$TARGET_DIR/AGI$EXTENSION"
+        fi
+    fi
+
+    log "Caminho do executável alvo: $EXECUTABLE_PATH"
+    log "Extensão alvo: $EXTENSION"
+}
+
+# --- FUNÇÃO DE EXECUÇÃO ---
+
+run_app() {
+    log "Iniciando AGI..."
+
+    if [ ! -f "$EXECUTABLE_PATH" ] && [ ! -d "$EXECUTABLE_PATH" ]; then
+        die "Executável não encontrado em: $EXECUTABLE_PATH. Rode o build primeiro!"
+    fi
+    
+    local EXEC_COMMAND
+    local DEBUG_FLAG=""
+    
+    if [ "$DEBUG_MODE" -eq 1 ]; then
+        DEBUG_FLAG="--debug"
+        log "Execução com flag de DEBUG ativo."
+    fi
+
+    # Lógica de execução baseada na extensão
+    case "$EXTENSION" in
+        .app) # macOS
+            EXEC_COMMAND="open -a '$BUILD_ROOT/$TARGET_DIR/AGI.app' --args $DEBUG_FLAG"
+            ;;
+        .AppImage) # Linux
+            chmod +x "$EXECUTABLE_PATH"
+            EXEC_COMMAND="'$EXECUTABLE_PATH' $DEBUG_FLAG"
+            ;;
+        .exe) # Windows (via WSL/Git Bash) ou Linux binário
+            EXEC_COMMAND="'$EXECUTABLE_PATH' $DEBUG_FLAG"
+            ;;
+        *)
+            # Executa o binário diretamente
+            EXEC_COMMAND="'$EXECUTABLE_PATH' $DEBUG_FLAG"
+            ;;
+    esac
+
+    log "Comando de execução: $EXEC_COMMAND"
+
+    if [ "$DRY_RUN" -eq 1 ]; then
+        log "DRY-RUN: Simulação de execução concluída."
+    else
+        log "Executando..."
+        # Usamos eval para garantir que as aspas e comandos complexos funcionem
+        eval "$EXEC_COMMAND"
+    fi
+
+    log "AGI encerrado."
+}
+
+# --- MENU INTERATIVO (Para modo padrão) ---
+
+show_menu() {
+    log "Modo Interativo Ativo."
+    echo "--------------------------------------------------------"
+    echo "       AGI Universal Launcher v3 (Executável: $EXTENSION)"
+    echo "--------------------------------------------------------"
+    echo "Executável alvo: $EXECUTABLE_PATH"
+    echo ""
+    echo "Opções:"
+    echo "  1) Iniciar AGI (Modo Normal)"
+    echo "  2) Iniciar AGI (Modo DEBUG - Logs detalhados)"
+    echo "  3) Ver caminho do executável"
+    echo "  4) Sair"
+    echo "--------------------------------------------------------"
+    
+    local choice
+    read -r -p "Escolha uma opção (1-4): " choice
+    
+    case $choice in
+        1) 
+            DEBUG_MODE=0
+            run_app
+            ;;
+        2)
+            DEBUG_MODE=1
+            run_app
+            ;;
+        3)
+            echo "Caminho: $EXECUTABLE_PATH"
+            log "Caminho exibido."
+            show_menu
+            ;;
+        4)
+            log "Encerrando script."
+            exit 0
+            ;;
+        *)
+            echo "Opção inválida. Tente novamente."
+            show_menu
+            ;;
+    esac
+}
+
+# --- EXECUÇÃO PRINCIPAL ---
+
+main() {
+    parse_args "$@"
+    detect_platform
+
+    if [ "$DRY_RUN" -eq 1 ] || [ "$INTERACTIVE_MENU" -eq 0 ]; then
+        # Modo não interativo (Debug ou Dry-Run)
+        run_app
+    else
+        # Modo interativo (padrão)
+        show_menu
+    fi
+    
+    log "Execução do launcher finalizada com sucesso."
+}
+
+# Inicia o script
+main "$@"
+
+# --- FIM DO SCRIPT ---

From d99954ed5d32341382ff06054a6924eff4c51392 Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 22:57:13 -0300
Subject: [PATCH 10/14] Create test-build.yml

---
 .github/workflows/test-build.yml | 38 ++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 .github/workflows/test-build.yml

diff --git a/.github/workflows/test-build.yml b/.github/workflows/test-build.yml
new file mode 100644
index 00000000..2ff4bed5
--- /dev/null
+++ b/.github/workflows/test-build.yml
@@ -0,0 +1,38 @@
+name: Test Build Sanity
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  test-on-ubuntu:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Run AGI Launcher on Ubuntu
+        run: ./agi-launcher-universal-v3.sh --dry-run
+        # O --dry-run aqui apenas valida o build, sem abri-lo de fato.
+        # Em um teste real, você rodaria sem o --dry-run para iniciar o app.
+
+  test-on-macos:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Run AGI Launcher on macOS
+        run: ./agi-launcher-universal-v3.sh --dry-run
+
+  test-on-windows:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Run AGI Launcher on Windows (via Git Bash)
+        # O Git Bash já está disponível nos runners do Windows
+        shell: bash
+        run: ./agi-launcher-universal-v3.sh --dry-run

From 38125af6891f366b06d5db25873ddb836418967d Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Mon, 13 Oct 2025 23:00:36 -0300
Subject: [PATCH 11/14] Create playwright-tests.yml

---
 .github/workflows/playwright-tests.yml | 63 ++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 .github/workflows/playwright-tests.yml

diff --git a/.github/workflows/playwright-tests.yml b/.github/workflows/playwright-tests.yml
new file mode 100644
index 00000000..7f8c531e
--- /dev/null
+++ b/.github/workflows/playwright-tests.yml
@@ -0,0 +1,63 @@
+name: Testes de Sanidade com Playwright
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test-on-ubuntu:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps
+
+      - name: Garantir permissão de execução do launcher
+        run: chmod +x ./agi-launcher-universal-v3.sh
+
+      - name: Iniciar app em background
+        run: |
+          ./agi-launcher-universal-v3.sh --Debug &
+          sleep 10  # Tempo para inicialização do app
+
+      - name: Rodar testes Playwright
+        run: npx playwright test
+
+  test-on-windows:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps
+
+      - name: Iniciar app via launcher
+        run: |
+          .\agi-launcher-universal-v3.sh --Debug
+          sleep 10  # Tempo para inicialização do app
+
+      - name: Rodar testes Playwright
+        run: npx playwright test

From 603de5852c32739b785dcdf828e4f7b89fd706b4 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 17 Oct 2025 18:16:59 +0000
Subject: [PATCH 12/14] Update README.md to 'Talos = AGI'

---
 README.md | 235 +-----------------------------------------------------
 1 file changed, 1 insertion(+), 234 deletions(-)

diff --git a/README.md b/README.md
index 2a312e6a..95af46d0 100644
--- a/README.md
+++ b/README.md
@@ -1,234 +1 @@
-<div align="center">
-
-![Talos Header](./assets/talos-header.jpeg)
-
-# Talos: An AI Protocol Owner
-
-[![Documentation](https://img.shields.io/badge/docs-talos.is-blue?style=for-the-badge&logo=gitbook)](https://docs.talos.is/)
-[![Version](https://img.shields.io/badge/version-0.1.0-green?style=for-the-badge)](https://github.com/talos-agent/talos/releases)
-[![Python](https://img.shields.io/badge/python-3.12+-blue?style=for-the-badge&logo=python)](https://python.org)
-[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
-
-**🤖 An AI agent designed to act as an autonomous owner for decentralized protocols**
-
-Talos is not just a chatbot; it is a sophisticated AI system that can manage and govern a protocol, ensuring its integrity and security through advanced supervision and governance capabilities.
-
-📖 **[Read the Documentation](https://docs.talos.is/)** | 🚀 **[Quick Start](#usage)** | 🛠️ **[Development](#development)**
-
-</div>
-
-## What is Talos?
-
-Talos is an AI agent that can:
-
--   **Govern Protocol Actions:** Talos uses a Hypervisor to monitor and approve or deny actions taken by other agents or system components. This ensures that all actions align with the protocol's rules and objectives.
--   **Evaluate Governance Proposals:** Talos can analyze and provide recommendations on governance proposals, considering their potential benefits, risks, and community feedback.
--   **Interact with the Community:** Talos can engage with the community on platforms like Twitter to provide updates, answer questions, and gather feedback.
--   **Manage its Own Codebase:** Talos can interact with GitHub to manage its own source code, including reviewing and committing changes.
--   **Update Documentation:** Talos can update its own documentation on GitBook to ensure it remains accurate and up-to-date.
-
-## Directory Structure
-
-The repository is structured as follows:
-
--   `.github/`: Contains GitHub Actions workflows for CI/CD.
--   `src/`: Contains the source code for the Talos agent.
-    -   `talos/`: Contains the main source code for the Talos agent.
-        -   `core/`: Contains the core components of the agent, such as the CLI and the main agent loop.
-        -   `hypervisor/`: Contains the Hypervisor and Supervisor components, which are responsible for overseeing the agent's actions.
-        -   `services/`: Contains the different services that the agent can perform, such as evaluating proposals.
-        -   `prompts/`: Contains the prompts used by the agent.
-        -   `tools/`: Contains the tools that the agent can use, such as GitBook, GitHub, IPFS, and Twitter.
--   `tests/`: Contains the tests for the Talos agent.
--   `proposal_example.py`: An example of how to use the agent to evaluate a proposal.
-
-## Key Components
-
-Talos is comprised of several key components that allow it to function as a decentralized AI protocol owner:
-
--   **Hypervisor and Supervisor:** The Hypervisor is the core of Talos's governance capabilities. It monitors all actions and uses a Supervisor to approve or deny them based on a set of rules and the agent's history. This protects the protocol from malicious or erroneous actions.
--   **Proposal Evaluation System:** Talos can systematically evaluate governance proposals, providing a detailed analysis to help stakeholders make informed decisions.
--   **Tool-Based Architecture:** Talos uses a variety of tools to interact with external services like Twitter, GitHub, and GitBook, allowing it to perform a wide range of tasks.
-
-## Services
-
-Talos provides a set of services for interacting with various platforms:
-
--   **Twitter:** Talos can use its Twitter service to post tweets, reply to mentions, and monitor conversations, allowing it to engage with the community and stay informed about the latest developments.
--   **GitHub:** The GitHub service enables Talos to interact with repositories, manage issues, and review and commit code. This allows Talos to autonomously manage its own codebase and contribute to other projects.
--   **GitBook:** With the GitBook service, Talos can create, edit, and manage documentation. This ensures that the project's documentation is always up-to-date.
-
-## Development
-
-This project uses `uv` for dependency management and requires Python 3.12+.
-
-1.  Create a virtual environment:
-
-    ```bash
-    uv venv
-    ```
-
-2.  Activate the virtual environment:
-
-    ```bash
-    source .venv/bin/activate
-    ```
-
-3.  Install dependencies:
-
-    ```bash
-    ./scripts/install_deps.sh
-    ```
-
-## Usage
-
-### Interactive CLI
-
-To start the interactive CLI, run the following command:
-
-```bash
-export OPENAI_API_KEY="your-openai-api-key"
-export PINATA_API_KEY="your-pinata-api-key"
-export PINATA_SECRET_API_KEY="your-pinata-secret-api-key"
-uv run talos
-```
-
-You can then interact with the agent in a continuous conversation. To exit, type `exit`.
-
-### Non-Interactive Mode
-
-Run a single query and exit:
-
-```bash
-uv run talos "your query here"
-```
-
-### Daemon Mode
-
-To run the agent in daemon mode for continuous operation with scheduled jobs:
-
-```bash
-export OPENAI_API_KEY="your-openai-api-key"
-export GITHUB_API_TOKEN="your-github-token"
-export TWITTER_BEARER_TOKEN="your-twitter-bearer-token"
-export PINATA_API_KEY="your-pinata-api-key"
-export PINATA_SECRET_API_KEY="your-pinata-secret-api-key"
-uv run talos daemon
-```
-
-The daemon will run continuously, executing scheduled jobs and can be gracefully shutdown with SIGTERM or SIGINT.
-
-### Available CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `twitter` | Twitter-related operations and sentiment analysis |
-| `github` | GitHub repository management and PR reviews |
-| `proposals` | Governance proposal evaluation |
-| `memory` | Memory management and search operations |
-| `arbiscan` | Arbitrum blockchain contract source code retrieval |
-| `generate-keys` | Generate RSA key pairs for encryption |
-| `get-public-key` | Retrieve the current public key |
-| `encrypt` | Encrypt data using public key |
-| `decrypt` | Decrypt data using private key |
-| `daemon` | Run in continuous daemon mode |
-| `cleanup-users` | Clean up temporary users and conversation data |
-| `db-stats` | Show database statistics |
-
-For detailed command usage, see the [CLI Documentation](https://docs.talos.is/cli/overview/).
-
-### Docker Usage
-
-#### Building and Running with Docker
-
-1. Build the Docker image:
-   ```bash
-   docker build -t talos-agent .
-   ```
-
-2. Run the container with environment variables:
-   ```bash
-   docker run -d \
-     -e OPENAI_API_KEY="your-openai-api-key" \
-     -e GITHUB_API_TOKEN="your-github-token" \
-     -e TWITTER_BEARER_TOKEN="your-twitter-bearer-token" \
-     -e PINATA_API_KEY="your-pinata-api-key" \
-     -e PINATA_SECRET_API_KEY="your-pinata-secret-api-key" \
-     --name talos-agent \
-     talos-agent
-   ```
-
-3. View logs:
-   ```bash
-   docker logs -f talos-agent
-   ```
-
-4. Graceful shutdown:
-   ```bash
-   docker stop talos-agent
-   ```
-
-#### Using Docker Compose
-
-1. Create a `.env` file with your API keys:
-   ```bash
-   OPENAI_API_KEY=your-openai-api-key
-   GITHUB_API_TOKEN=your-github-token
-   TWITTER_BEARER_TOKEN=your-twitter-bearer-token
-   PINATA_API_KEY=your-pinata-api-key
-   PINATA_SECRET_API_KEY=your-pinata-secret-api-key
-   ```
-
-2. Start the service:
-   ```bash
-   docker-compose up -d
-   ```
-
-3. View logs:
-   ```bash
-   docker-compose logs -f
-   ```
-
-4. Stop the service:
-   ```bash
-   docker-compose down
-   ```
-
-#### Required Environment Variables
-
-- `OPENAI_API_KEY`: Required for AI functionality
-- `PINATA_API_KEY`: Required for IPFS operations
-- `PINATA_SECRET_API_KEY`: Required for IPFS operations
-
-#### Optional Environment Variables
-
-- `GITHUB_API_TOKEN`: Required for GitHub operations
-- `TWITTER_BEARER_TOKEN`: Required for Twitter functionality
-- `ARBISCAN_API_KEY`: Optional for higher rate limits when accessing Arbitrum contract data
-
-#### Graceful Shutdown
-
-The Docker container supports graceful shutdown. When you run `docker stop`, it sends a SIGTERM signal to the process, which triggers:
-
-1. Stopping the job scheduler
-2. Completing any running jobs
-3. Clean shutdown of all services
-
-The container will wait up to 10 seconds for graceful shutdown before forcing termination.
-
-### Proposal Evaluation Example
-
-To run the proposal evaluation example, run the following command:
-
-```bash
-export OPENAI_API_key="<OPENAI_API_KEY>"
-python proposal_example.py
-```
-
-## Testing, Linting and Type Checking
-
-To run the test suite, lint, and type-check the code, run the following command:
-
-```bash
-./scripts/run_checks.sh
-```
+Talos = AGI
\ No newline at end of file

From bf9a6d116dfc59cf8630b97004d7ba4d32cd0ca8 Mon Sep 17 00:00:00 2001
From: arkhen <arkhen.oliveira@gmail.com>
Date: Fri, 17 Oct 2025 15:22:10 -0300
Subject: [PATCH 13/14] Update README.md

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 2a312e6a..bb08a54c 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
 <div align="center">
 
-![Talos Header](./assets/talos-header.jpeg)
+![AGI Header](./assets/talos-header.jpeg)
 
-# Talos: An AI Protocol Owner
+# AGI: An AI Protocol Owner
 
 [![Documentation](https://img.shields.io/badge/docs-talos.is-blue?style=for-the-badge&logo=gitbook)](https://docs.talos.is/)
 [![Version](https://img.shields.io/badge/version-0.1.0-green?style=for-the-badge)](https://github.com/talos-agent/talos/releases)

From a9ad9873a20de7455bbf687893321fa327334173 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 17 Oct 2025 22:04:03 +0000
Subject: [PATCH 14/14] feat: Add monitoring command

This commit introduces a new `monitoring` command to the Talos CLI.
The command uses the `sampler` tool to provide real-time monitoring
of the Talos agent.

A default configuration file is provided at `config/sampler-config.yml`
to monitor database statistics.

The `README.md` has been updated to document the new command and its
dependency on the `sampler` tool.
---
 README.md                   |  5 +++++
 config/sampler-config.yml   | 10 ++++++++++
 src/talos/cli/main.py       |  2 ++
 src/talos/cli/monitoring.py | 40 +++++++++++++++++++++++++++++++++++++
 4 files changed, 57 insertions(+)
 create mode 100644 config/sampler-config.yml
 create mode 100644 src/talos/cli/monitoring.py

diff --git a/README.md b/README.md
index 0e329028..37ec47ca 100644
--- a/README.md
+++ b/README.md
@@ -134,9 +134,14 @@ The daemon will run continuously, executing scheduled jobs and can be gracefully
 | `daemon` | Run in continuous daemon mode |
 | `cleanup-users` | Clean up temporary users and conversation data |
 | `db-stats` | Show database statistics |
+| `monitoring` | Start the monitoring service |
 
 For detailed command usage, see the [CLI Documentation](https://docs.talos.is/cli/overview/).
 
+### Monitoring
+
+The `monitoring` command uses the [Sampler](https://github.com/sqshq/sampler) tool to provide real-time monitoring of the Talos agent. To use this feature, you must have Sampler installed and available in your system's PATH.
+
 ### Docker Usage
 
 #### Building and Running with Docker
diff --git a/config/sampler-config.yml b/config/sampler-config.yml
new file mode 100644
index 00000000..7de33334
--- /dev/null
+++ b/config/sampler-config.yml
@@ -0,0 +1,10 @@
+barcharts:
+  - title: Database Stats
+    rate-ms: 5000
+    items:
+      - label: Total Users
+        sample: uv run talos db-stats | grep "Total users" | awk '{print $3}'
+      - label: Permanent Users
+        sample: uv run talos db-stats | grep "Permanent users" | awk '{print $3}'
+      - label: Temporary Users
+        sample: uv run talos db-stats | grep "Temporary users" | awk '{print $3}'
\ No newline at end of file
diff --git a/src/talos/cli/main.py b/src/talos/cli/main.py
index fc023ce4..cff2d1e9 100644
--- a/src/talos/cli/main.py
+++ b/src/talos/cli/main.py
@@ -17,6 +17,7 @@
 from talos.cli.github import github_app
 from talos.cli.memory import memory_app
 from talos.cli.migrations import app as migrations_app
+from talos.cli.monitoring import app as monitoring_app
 from talos.cli.proposals import proposals_app
 from talos.cli.twitter import twitter_app
 from talos.core.main_agent import MainAgent
@@ -33,6 +34,7 @@
 app.add_typer(arbiscan_app, name="arbiscan")
 app.add_typer(contracts_app, name="contracts")
 app.add_typer(migrations_app, name="migrations")
+app.add_typer(monitoring_app, name="monitoring")
 
 
 @app.callback()
diff --git a/src/talos/cli/monitoring.py b/src/talos/cli/monitoring.py
new file mode 100644
index 00000000..5773ccb6
--- /dev/null
+++ b/src/talos/cli/monitoring.py
@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+import typer
+
+app = typer.Typer()
+
+
+@app.command()
+def start(
+    config: str = typer.Option(
+        "config/sampler-config.yml",
+        "--config",
+        "-c",
+        help="Path to the sampler config file.",
+    )
+):
+    """
+    Starts the monitoring service.
+    """
+    if not Path(config).exists():
+        print(f"Config file not found at {config}")
+        raise typer.Exit(1)
+
+    try:
+        subprocess.run(["sampler", "-c", config], check=True)
+    except FileNotFoundError:
+        print("Error: 'sampler' command not found.")
+        print("Please install Sampler and ensure it is in your PATH.")
+        print("See here for installation instructions: https://github.com/sqshq/sampler")
+        raise typer.Exit(1)
+    except subprocess.CalledProcessError as e:
+        print(f"Error running sampler: {e}")
+        raise typer.Exit(1)
+
+
+if __name__ == "__main__":
+    app()
\ No newline at end of file