Merge pull request 'PR Automatica OpenCode: opencode-issue-7' (#8) from opencode-issue-7 into main

Reviewed-on: #8
closes #7

.gitea/workflows/opencode.yml

@@ -1,6 +1,8 @@
 name: OpenCode Gitea Integration
 
 on:
+  issues:
+    types: [opened]
   issue_comment:
     types: [created]
   pull_request_review_comment:
@@ -15,8 +17,10 @@ jobs:
   opencode-gitea:
     if: |
       github.event_name == 'workflow_dispatch' ||
-      contains(github.event.comment.body, '/oc') ||
-      contains(github.event.comment.body, '/opencode')
+      (github.event_name == 'issues' &&
+        (contains(github.event.issue.body, '/oc') || contains(github.event.issue.body, '/opencode'))) ||
+      (github.event_name != 'issues' &&
+        (contains(github.event.comment.body, '/oc') || contains(github.event.comment.body, '/opencode')))
     runs-on: ubuntu-latest
     timeout-minutes: 20
 
@@ -24,8 +28,9 @@ jobs:
       GITEA_API_URL: "https://gitea.maribit.it"
       GITEA_TOKEN: ${{ secrets.BOT_GITEA_TOKEN }}
       REPO_FULL_NAME: ${{ github.repository }}
-      COMMENT_BODY: ${{ github.event.comment.body || github.event.inputs.prompt }}
-      COMMENT_AUTHOR: ${{ github.event.comment.user.login || github.actor }}
+      COMMENT_BODY: ${{ github.event.comment.body || github.event.issue.body || github.event.inputs.prompt }}
+      COMMENT_AUTHOR: ${{ github.event.comment.user.login || github.event.issue.user.login || github.actor }}
+      COMMENT_ID: ${{ github.event.comment.id }}
       IS_PR_EVENT: ${{ github.event_name == 'pull_request_review_comment' }}
       IS_MANUAL: ${{ github.event_name == 'workflow_dispatch' }}
       PR_NUMBER_FROM_EVENT: ${{ github.event.pull_request.number }}
@@ -38,10 +43,7 @@ jobs:
     steps:
       - name: Verifica autorizzazione utente
         run: |
-          # Whitelist esplicita: nessuna esecuzione automatica per utenti non fidati.
           ALLOWED_USERS="maria nicola"
-          # L'esecuzione manuale (workflow_dispatch) è già ristretta a chi ha
-          # permessi di scrittura sul repo, quindi la lasciamo passare.
           if [ "$IS_MANUAL" = "true" ]; then
             exit 0
           fi
@@ -50,6 +52,27 @@ jobs:
             exit 1
           fi
 
+      # Feedback immediato: 👀 sul commento (o sulla issue) che ha invocato l'agente.
+      # Le reazioni NON generano eventi issue_comment -> nessun doppio run.
+      - name: Reagisci al comando (👀)
+        id: react
+        run: |
+          API="$GITEA_API_URL/api/v1/repos/$REPO_FULL_NAME"
+          if [ -n "$COMMENT_ID" ]; then
+            RPATH="issues/comments/$COMMENT_ID/reactions"
+          elif [ -n "$ISSUE_NUMBER" ]; then
+            RPATH="issues/$ISSUE_NUMBER/reactions"
+          else
+            RPATH=""
+          fi
+          echo "path=$RPATH" >> "$GITHUB_OUTPUT"
+          if [ -n "$RPATH" ]; then
+            curl -s -X POST "$API/$RPATH" \
+              -H "Authorization: token $GITEA_TOKEN" \
+              -H "Content-Type: application/json" \
+              -d '{"content":"eyes"}' >/dev/null || true
+          fi
+
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
@@ -70,20 +93,16 @@ jobs:
           API="$GITEA_API_URL/api/v1/repos/$REPO_FULL_NAME"
 
           if [ "$IS_MANUAL" = "true" ]; then
-            # Esecuzione manuale: nessuna issue/PR di contesto, branch dedicato.
             IS_PR=false
             PR_NUMBER=""
             BRANCH_NAME="opencode-manual-$RUN_NUMBER"
           elif [ "$IS_PR_EVENT" = "true" ]; then
-            # Commento inline su una review: PR e branch noti dal payload.
             IS_PR=true
             PR_NUMBER="$PR_NUMBER_FROM_EVENT"
             BRANCH_NAME="$PR_HEAD_REF_FROM_EVENT"
           else
-            # issue_comment: può essere una issue "pura" o un commento su una PR.
+            # issue / issue_comment: la chiave "pull_request" c'è sempre ma vale null per le issue.
             ISSUE_JSON=$(curl -s -H "Authorization: token $GITEA_TOKEN" "$API/issues/$ISSUE_NUMBER")
-            # NB: l'API Gitea restituisce SEMPRE la chiave "pull_request",
-            # ma vale null per le issue normali: va controllato il VALORE, non la chiave.
             if [ "$(echo "$ISSUE_JSON" | jq -r '.pull_request // empty')" != "" ]; then
               IS_PR=true
               PR_NUMBER="$ISSUE_NUMBER"
@@ -96,9 +115,8 @@ jobs:
             fi
           fi
 
-          # Rete di sicurezza contro branch vuoti / "null".
           if [ -z "$BRANCH_NAME" ] || [ "$BRANCH_NAME" = "null" ]; then
-            echo "BRANCH_NAME non valido ('$BRANCH_NAME'): impossibile determinare il contesto. Interrompo."
+            echo "BRANCH_NAME non valido ('$BRANCH_NAME'). Interrompo."
             exit 1
           fi
 
@@ -107,18 +125,16 @@ jobs:
           echo "branch_name=$BRANCH_NAME" >> "$GITHUB_OUTPUT"
 
           if [ "$IS_PR" = "true" ]; then
-            # Continua sullo STESSO branch della PR esistente (loop di review).
             git fetch origin "$BRANCH_NAME"
             git checkout -B "$BRANCH_NAME" "origin/$BRANCH_NAME"
           elif git ls-remote --exit-code --heads origin "$BRANCH_NAME" >/dev/null 2>&1; then
-            # Un run precedente ha già creato questo branch: riprendilo.
             git fetch origin "$BRANCH_NAME"
             git checkout -B "$BRANCH_NAME" "origin/$BRANCH_NAME"
           else
             git checkout -b "$BRANCH_NAME"
           fi
 
-      - name: Raccogli contesto aggiuntivo (diff + commenti di review, se PR)
+      - name: Raccogli contesto aggiuntivo (diff + commenti, se PR)
         run: |
           API="$GITEA_API_URL/api/v1/repos/$REPO_FULL_NAME"
           : > /tmp/context.txt
@@ -168,28 +184,30 @@ jobs:
           git commit -m "OpenCode (big-pickle): $BRANCH_NAME"
           git push origin "$BRANCH_NAME"
 
-          # Apri una PR solo se stiamo partendo da zero (issue o run manuale),
-          # non se stiamo già iterando su una PR esistente.
           if [ "${{ steps.ctx.outputs.is_pr }}" != "true" ]; then
-            TITLE="PR Automatica OpenCode: $BRANCH_NAME"
             curl -s -X POST "$API/pulls" \
               -H "Authorization: token $GITEA_TOKEN" \
               -H "Content-Type: application/json" \
-              -d "{\"base\":\"main\",\"head\":\"$BRANCH_NAME\",\"title\":\"$TITLE\",\"body\":\"Generata da big-pickle su richiesta di @$COMMENT_AUTHOR.\"}"
+              -d "{\"base\":\"main\",\"head\":\"$BRANCH_NAME\",\"title\":\"PR Automatica OpenCode: $BRANCH_NAME\",\"body\":\"Generata da big-pickle su richiesta di @$COMMENT_AUTHOR.\"}"
           fi
 
-      - name: Commenta l'esito
-        if: always()
+      # Stato finale via reazione (niente commenti -> niente self-trigger).
+      - name: Reazione finale 🚀
+        if: success() && steps.react.outputs.path != ''
         continue-on-error: true
         run: |
           API="$GITEA_API_URL/api/v1/repos/$REPO_FULL_NAME"
-          TARGET="${{ steps.ctx.outputs.pr_number || env.ISSUE_NUMBER }}"
-          # Su esecuzione manuale non c'è una issue/PR di partenza su cui commentare.
-          if [ -z "$TARGET" ]; then
-            echo "Nessun target su cui commentare (probabile run manuale). Salto."
-            exit 0
-          fi
-          curl -sS -X POST "$API/issues/$TARGET/comments" \
+          curl -s -X POST "$API/${{ steps.react.outputs.path }}" \
             -H "Authorization: token $GITEA_TOKEN" \
             -H "Content-Type: application/json" \
-            -d "{\"body\":\"🤖 OpenCode ha completato l'elaborazione della richiesta di @$COMMENT_AUTHOR.\"}"
+            -d '{"content":"rocket"}' >/dev/null || true
+
+      - name: Reazione finale 😕 (fallimento)
+        if: failure() && steps.react.outputs.path != ''
+        continue-on-error: true
+        run: |
+          API="$GITEA_API_URL/api/v1/repos/$REPO_FULL_NAME"
+          curl -s -X POST "$API/${{ steps.react.outputs.path }}" \
+            -H "Authorization: token $GITEA_TOKEN" \
+            -H "Content-Type: application/json" \
+            -d '{"content":"confused"}' >/dev/null || true

README.md

@@ -2,4 +2,46 @@
 
 Questo repository è un test per verificare il funzionamento delle **Actions** e dell'**automazione agentica** collegata a eventi su Gitea.
 
-Lo scopo è sperimentare l'esecuzione automatica di workflow in risposta a eventi come push, pull request e altri trigger, utilizzando agenti AI per operazioni di review, merge e gestione del repository.
+Lo scopo è sperimentare l'esecuzione automatica di workflow in risposta a eventi come push, pull request e altri trigger, utilizzando agenti AI per operazioni di review, merge e gestione del repository.
+
+## Workflow: `Gitea Actions Demo` (`.gitea/workflows/demo.yml`)
+
+Workflow dimostrativo che si attiva ad ogni **push** su qualsiasi branch. Esegue su un container `node:20-alpine` e stampa una serie di messaggi informativi via `echo` per illustrare il funzionamento base di Gitea Actions:
+- Mostra l'evento che ha scatenato il workflow (`gitea.event_name`)
+- Mostra il runner OS e il branch/repository coinvolto
+- Fa il checkout del codice tramite `actions/checkout@v4`
+- Elenca i file nella workspace
+- Comunica lo stato finale del job (`job.status`)
+
+Non esegue operazioni di modifica o deploy: è puramente a scopo educativo/dimostrativo.
+
+## Workflow: `OpenCode Gitea Integration` (`.gitea/workflows/opencode.yml`)
+
+Workflow di automazione agentica che integra **OpenCode** (agente AI) con Gitea. Si attiva su quattro eventi:
+
+| Evento | Descrizione |
+|---|---|
+| `issues: [opened]` | Apertura di una nuova issue |
+| `issue_comment: [created]` | Nuovo commento su una issue |
+| `pull_request_review_comment: [created]` | Nuovo commento su una PR (review) |
+| `workflow_dispatch` | Esecuzione manuale tramite UI / API |
+
+Il workflow procede solo se il corpo della issue/commento contiene `/oc` o `/opencode` (oppure se è un'esecuzione manuale). L'autore deve essere tra gli utenti autorizzati (`maria`, `nicola`), altrimenti il job viene interrotto.
+
+### Schema di esecuzione
+
+1. **Autorizzazione** — Verifica che l'utente sia nella whitelist.
+2. **Reazione 👀** — Aggiunge una reazione "eyes" al commento/issue di trigger (feedback visivo immediato senza generare nuovi eventi).
+3. **Checkout** — Clona il repository con storia completa (`fetch-depth: 0`).
+4. **Installazione OpenCode** — Scarica e installa la CLI di OpenCode via `curl | bash`.
+5. **Determinazione contesto** — Capisce se si è in una issue, in una PR o in esecuzione manuale:
+   - **PR**: fa il fetch e checkout del branch della PR.
+   - **Issue**: crea un nuovo branch `opencode-issue-<N>` a partire da `main`.
+   - **Manuale**: crea un branch `opencode-manual-<run_number>`.
+6. **Raccolta contesto** — Se si tratta di una PR, scarica il **diff** e i **commenti** recenti per fornire contesto all'agente.
+7. **Pulizia comando** — Rimuove `/oc` o `/opencode` dal prompt, lasciando solo le istruzioni utente.
+8. **Esecuzione OpenCode** — Lancia l'agente AI con modello `opencode/big-pickle`, passando il contesto raccolto e la richiesta dell'utente. L'agente può leggere, modificare e creare file nel repository.
+9. **Push e PR** — Se ci sono modifiche, le committa e le pusha sul branch. Se si sta lavorando su una issue (non PR), apre automaticamente una **Pull Request** verso `main`.
+10. **Reazione finale** — Aggiunge una reazione 🚀 in caso di successo o 😕 in caso di fallimento.
+
+Il workflow è progettato per evitare auto-trigger: le reazioni alle issue/commenti non generano eventi `issue_comment`, e il workflow non scrive mai commenti (solo reazioni), prevenendo loop infiniti.