@neurocode-ai/web 1.18.8

package/src/content/docs/pt-br/github.mdx

@@ -0,0 +1,321 @@
+---
+title: GitHub
+description: Use o opencode em problemas e pull-requests do GitHub.
+---
+
+O opencode integra-se ao seu fluxo de trabalho do GitHub. Mencione `/opencode` ou `/oc` em seu comentário, e o opencode executará tarefas dentro do seu runner do GitHub Actions.
+
+---
+
+## Recursos
+
+- **Triagem de problemas**: Peça ao opencode para analisar um problema e explicá-lo para você.
+- **Corrigir e implementar**: Peça ao opencode para corrigir um problema ou implementar um recurso. E ele trabalhará em um novo branch e enviará um PR com todas as alterações.
+- **Seguro**: O opencode é executado dentro dos runners do seu GitHub.
+
+---
+
+## Instalação
+
+Execute o seguinte comando em um projeto que está em um repositório do GitHub:
+
+```bash
+opencode github install
+```
+
+Isso o guiará pela instalação do aplicativo GitHub, criação do fluxo de trabalho e configuração de segredos.
+
+---
+
+### Configuração Manual
+
+Ou você pode configurá-lo manualmente.
+
+1. **Instale o aplicativo GitHub**
+
+   Acesse [**github.com/apps/opencode-agent**](https://github.com/apps/opencode-agent). Certifique-se de que está instalado no repositório de destino.
+
+2. **Adicione o fluxo de trabalho**
+
+   Adicione o seguinte arquivo de fluxo de trabalho em `.github/workflows/opencode.yml` no seu repositório. Certifique-se de definir o `model` apropriado e as chaves de API necessárias em `env`.
+
+   ```yml title=".github/workflows/opencode.yml" {24,26}
+   name: opencode
+
+   on:
+     issue_comment:
+       types: [created]
+     pull_request_review_comment:
+       types: [created]
+
+   jobs:
+     opencode:
+       if: |
+         contains(github.event.comment.body, '/oc') ||
+         contains(github.event.comment.body, '/opencode')
+       runs-on: ubuntu-latest
+       permissions:
+         id-token: write
+       steps:
+          - name: Checkout repository
+            uses: actions/checkout@v6
+            with:
+              fetch-depth: 1
+              persist-credentials: false
+
+          - name: Run OpenCode
+           uses: anomalyco/opencode/github@latest
+           env:
+             ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+           with:
+             model: anthropic/claude-sonnet-4-20250514
+             # share: true
+             # github_token: xxxx
+   ```
+
+3. **Armazene as chaves de API em segredos**
+
+   Nas **configurações** da sua organização ou projeto, expanda **Segredos e variáveis** à esquerda e selecione **Ações**. E adicione as chaves de API necessárias.
+
+---
+
+## Configuração
+
+- `model`: O modelo a ser usado com o opencode. Tem o formato de `provider/model`. Isso é **obrigatório**.
+- `agent`: O agente a ser usado. Deve ser um agente primário. Retorna ao `default_agent` da configuração ou `"build"` se não encontrado.
+- `share`: Se deve compartilhar a sessão do opencode. O padrão é **true** para repositórios públicos.
+- `prompt`: Prompt personalizado opcional para substituir o comportamento padrão. Use isso para personalizar como o opencode processa solicitações.
+- `token`: Token de acesso do GitHub opcional para realizar operações como criar comentários, confirmar alterações e abrir pull requests. Por padrão, o opencode usa o token de acesso da instalação do aplicativo GitHub opencode, então commits, comentários e pull requests aparecem como se fossem da aplicação.
+
+  Alternativamente, você pode usar o [`GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) embutido do runner do GitHub Action sem instalar o aplicativo GitHub opencode. Apenas certifique-se de conceder as permissões necessárias em seu fluxo de trabalho:
+
+  ```yaml
+  permissions:
+    id-token: write
+    contents: write
+    pull-requests: write
+    issues: write
+  ```
+
+  Você também pode usar um [token de acesso pessoal](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)(PAT) se preferir.
+
+---
+
+## Eventos Suportados
+
+O opencode pode ser acionado pelos seguintes eventos do GitHub:
+
+| Tipo de Evento                | Acionado Por                                        | Detalhes                                                                                                                               |
+| ----------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `issue_comment`               | Comentário em um problema ou PR                     | Mencione `/opencode` ou `/oc` em seu comentário. O opencode lê o contexto e pode criar branches, abrir PRs ou responder.               |
+| `pull_request_review_comment` | Comentário em linhas de código específicas em um PR | Mencione `/opencode` ou `/oc` enquanto revisa o código. O opencode recebe o caminho do arquivo, números das linhas e contexto do diff. |
+| `issues`                      | Problema aberto ou editado                          | Aciona automaticamente o opencode quando problemas são criados ou modificados. Requer entrada de `prompt`.                             |
+| `pull_request`                | PR aberto ou atualizado                             | Aciona automaticamente o opencode quando PRs são abertos, sincronizados ou reabertos. Útil para revisões automatizadas.                |
+| `schedule`                    | Cron baseado em agendamento                         | Execute o opencode em um cronograma. Requer entrada de `prompt`. A saída vai para logs e PRs (sem problema para comentar).             |
+| `workflow_dispatch`           | Acionamento manual pela interface do GitHub         | Acione o opencode sob demanda através da aba Ações. Requer entrada de `prompt`. A saída vai para logs e PRs.                           |
+
+### Exemplo de Agendamento
+
+Execute o opencode em um cronograma para realizar tarefas automatizadas:
+
+```yaml title=".github/workflows/opencode-scheduled.yml"
+name: Scheduled OpenCode Task
+
+on:
+  schedule:
+    - cron: "0 9 * * 1" # Every Monday at 9am UTC
+
+jobs:
+  opencode:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+       - name: Run OpenCode
+         uses: anomalyco/opencode/github@latest
+         env:
+           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+         with:
+           model: anthropic/claude-sonnet-4-20250514
+           prompt: |
+             Revise a base de código para quaisquer comentários TODO e crie um resumo.
+             Se encontrar problemas que valham a pena resolver, abra um issue para rastreá-los.
+```
+
+Para eventos agendados, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções. Fluxos de trabalho agendados são executados sem um contexto de usuário para verificação de permissões, então o fluxo de trabalho deve conceder `contents: write` e `pull-requests: write` se você espera que o opencode crie branches ou PRs.
+
+---
+
+### Exemplo de Pull Request
+
+Revise automaticamente PRs quando forem abertos ou atualizados:
+
+```yaml title=".github/workflows/opencode-review.yml"
+name: opencode-review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+      pull-requests: read
+      issues: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+       - uses: anomalyco/opencode/github@latest
+         env:
+           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+         with:
+           model: anthropic/claude-sonnet-4-20250514
+           use_github_token: true
+           prompt: |
+             Revise este pull request:
+             - Verifique problemas de qualidade de código
+             - Procure por potenciais bugs
+             - Sugira melhorias
+```
+
+Para eventos de `pull_request`, se nenhum `prompt` for fornecido, o opencode padrão será revisar o pull request.
+
+---
+
+### Exemplo de Triagem de Problemas
+
+Triagem automática de novos problemas. Este exemplo filtra contas com mais de 30 dias para reduzir spam:
+
+```yaml title=".github/workflows/opencode-triage.yml"
+name: Issue Triage
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  triage:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Check account age
+        id: check
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const user = await github.rest.users.getByUsername({
+              username: context.payload.issue.user.login
+            });
+            const created = new Date(user.data.created_at);
+            const days = (Date.now() - created) / (1000 * 60 * 60 * 24);
+            return days >= 30;
+          result-encoding: string
+
+      - uses: actions/checkout@v6
+        if: steps.check.outputs.result == 'true'
+        with:
+          persist-credentials: false
+
+       - uses: anomalyco/opencode/github@latest
+         if: steps.check.outputs.result == 'true'
+         env:
+           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+         with:
+           model: anthropic/claude-sonnet-4-20250514
+           prompt: |
+             Revise este issue. Se houver uma correção clara ou docs relevantes:
+             - Forneça links de documentação
+             - Adicione orientação sobre tratamento de erros para exemplos de código
+             Caso contrário, não comente.
+```
+
+Para eventos de `issues`, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções.
+
+---
+
+## Prompts Personalizados
+
+Substitua o prompt padrão para personalizar o comportamento do opencode para seu fluxo de trabalho.
+
+```yaml title=".github/workflows/opencode.yml"
+- uses: anomalyco/opencode/github@latest
+  with:
+    model: anthropic/claude-sonnet-4-5
+    prompt: |
+      Revise este pull request:
+      - Verifique problemas de qualidade de código
+      - Procure por potenciais bugs
+      - Sugira melhorias
+```
+
+Isso é útil para impor critérios de revisão específicos, padrões de codificação ou áreas de foco relevantes para seu projeto.
+
+---
+
+## Exemplos
+
+Aqui estão alguns exemplos de como você pode usar o opencode no GitHub.
+
+- **Explicar um problema**
+
+  Adicione este comentário em um problema do GitHub.
+
+  ```
+  /opencode explain this issue
+  ```
+
+  O opencode lerá toda a conversa, incluindo todos os comentários, e responderá com uma explicação clara.
+
+- **Corrigir um problema**
+
+  Em um problema do GitHub, diga:
+
+  ```
+  /opencode fix this
+  ```
+
+  E o opencode criará um novo branch, implementará as alterações e abrirá um PR com as mudanças.
+
+- **Revisar PRs e fazer alterações**
+
+  Deixe o seguinte comentário em um PR do GitHub.
+
+  ```
+  Delete the attachment from S3 when the note is removed /oc
+  ```
+
+  O opencode implementará a alteração solicitada e a confirmará no mesmo PR.
+
+- **Revisar linhas de código específicas**
+
+  Deixe um comentário diretamente nas linhas de código na aba "Files" do PR. O opencode detecta automaticamente o arquivo, os números das linhas e o contexto do diff para fornecer respostas precisas.
+
+  ```
+  [Comentário em linhas específicas na aba Files]
+  /oc add error handling here
+  ```
+
+  Ao comentar sobre linhas específicas, o opencode recebe:
+  - O arquivo exato sendo revisado
+  - As linhas específicas de código
+  - O contexto do diff ao redor
+  - Informações sobre números de linha
+
+  Isso permite solicitações mais direcionadas sem precisar especificar caminhos de arquivos ou números de linhas manualmente.

package/src/content/docs/pt-br/gitlab.mdx

@@ -0,0 +1,195 @@
+---
+title: GitLab
+description: Use o opencode em problemas e solicitações de mesclagem do GitLab.
+---
+
+O opencode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo.
+
+Em ambos os casos, o opencode será executado em seus runners do GitLab.
+
+---
+
+## GitLab CI
+
+O opencode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um [componente CI](https://docs.gitlab.com/ee/ci/components/)
+
+Aqui estamos usando um componente CI/CD criado pela comunidade para opencode — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode).
+
+---
+
+### Recursos
+
+- **Use configuração personalizada por trabalho**: Configure o opencode com um diretório de configuração personalizado, por exemplo `./config/#custom-directory` para habilitar ou desabilitar funcionalidades por invocação do opencode.
+- **Configuração mínima**: O componente CI configura o opencode em segundo plano, você só precisa criar a configuração do opencode e o prompt inicial.
+- **Flexível**: O componente CI suporta várias entradas para personalizar seu comportamento.
+
+---
+
+### Configuração
+
+1. Armazene seu JSON de autenticação do opencode como variáveis de ambiente do tipo File em **Configurações** > **CI/CD** > **Variáveis**. Certifique-se de marcá-las como "Mascaradas e ocultas".
+2. Adicione o seguinte ao seu arquivo `.gitlab-ci.yml`.
+
+   ```yaml title=".gitlab-ci.yml"
+   include:
+     - component: $CI_SERVER_FQDN/nagyv/gitlab-opencode/opencode@2
+       inputs:
+         config_dir: ${CI_PROJECT_DIR}/opencode-config
+         auth_json: $OPENCODE_AUTH_JSON # O nome da variável para seu JSON de autenticação do OpenCode
+         command: optional-custom-command
+         message: "Seu prompt aqui"
+   ```
+
+Para mais entradas e casos de uso [consulte a documentação](https://gitlab.com/explore/catalog/nagyv/gitlab-opencode) deste componente.
+
+---
+
+## GitLab Duo
+
+O opencode se integra ao seu fluxo de trabalho do GitLab.
+Mencione `@opencode` em um comentário, e o opencode executará tarefas dentro do seu pipeline CI do GitLab.
+
+---
+
+### Recursos
+
+- **Triagem de problemas**: Peça ao opencode para analisar um problema e explicá-lo para você.
+- **Corrigir e implementar**: Peça ao opencode para corrigir um problema ou implementar uma funcionalidade.
+  Ele criará um novo branch e abrirá uma solicitação de mesclagem com as alterações.
+- **Seguro**: O opencode é executado em seus runners do GitLab.
+
+---
+
+### Configuração
+
+O opencode é executado em seu pipeline CI/CD do GitLab, aqui está o que você precisará para configurá-lo:
+
+:::tip
+Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) para instruções atualizadas.
+:::
+
+1.  Configure seu ambiente GitLab
+2.  Configure CI/CD
+3.  Obtenha uma chave de API do provedor de modelo de IA
+4.  Crie uma conta de serviço
+5.  Configure variáveis de CI/CD
+6.  Crie um arquivo de configuração de fluxo, aqui está um exemplo:
+
+        <details>
+
+    <summary>Configuração de fluxo</summary>
+
+    ```yaml
+    image: node:22-slim
+    commands:
+      - echo "Instalando opencode"
+      - npm install --global opencode-ai
+      - echo "Instalando glab"
+      - export GITLAB_TOKEN=$GITLAB_TOKEN_OPENCODE
+      - apt-get update --quiet && apt-get install --yes curl wget gpg git && rm --recursive --force /var/lib/apt/lists/*
+      - curl --silent --show-error --location "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | bash
+      - apt-get install --yes glab
+      - echo "Configurando glab"
+      - echo $GITLAB_HOST
+      - echo "Criando configuração de auth do OpenCode"
+      - mkdir --parents ~/.local/share/opencode
+      - |
+        cat > ~/.local/share/opencode/auth.json << EOF
+        {
+          "anthropic": {
+            "type": "api",
+            "key": "$ANTHROPIC_API_KEY"
+          }
+        }
+        EOF
+      - echo "Configurando git"
+      - git config --global user.email "opencode@gitlab.com"
+      - git config --global user.name "OpenCode"
+      - echo "Testando glab"
+      - glab issue list
+      - echo "Executando OpenCode"
+      - |
+        opencode run "
+        Você é um assistente de IA ajudando com operações do GitLab.
+
+        Contexto: $AI_FLOW_CONTEXT
+        Tarefa: $AI_FLOW_INPUT
+        Evento: $AI_FLOW_EVENT
+
+        Por favor, execute a tarefa solicitada usando as ferramentas disponíveis do GitLab.
+        Seja minucioso em sua análise e forneça explicações claras.
+
+        <important>
+        Por favor, use a CLI glab para acessar dados do GitLab. A CLI glab já foi autenticada. Você pode executar os comandos correspondentes.
+
+        Se for solicitado a resumir um MR ou problema ou solicitado a fornecer mais informações, poste uma nota de volta no MR/Problema para que o usuário possa ver.
+        Você não precisa commitar ou enviar alterações, isso será feito automaticamente com base nas alterações de arquivo que você fizer.
+        </important>
+        "
+      - git checkout --branch $CI_WORKLOAD_REF origin/$CI_WORKLOAD_REF
+      - echo "Verificando alterações no git e enviando se existirem"
+      - |
+        if ! git diff --quiet || ! git diff --cached --quiet || [ --not --zero "$(git ls-files --others --exclude-standard)" ]; then
+          echo "Alterações git detectadas, adicionando e enviando..."
+          git add .
+          if git diff --cached --quiet; then
+            echo "Nenhuma alteração preparada para commit"
+          else
+            echo "Commitando alterações para o branch: $CI_WORKLOAD_REF"
+            git commit --message "Codex changes"
+            echo "Enviando alterações para $CI_WORKLOAD_REF"
+            git push https://gitlab-ci-token:$GITLAB_TOKEN@$GITLAB_HOST/gl-demo-ultimate-dev-ai-epic-17570/test-java-project.git $CI_WORKLOAD_REF
+            echo "Alterações enviadas com sucesso"
+          fi
+        else
+          echo "Nenhuma alteração git detectada, pulando envio"
+        fi
+    variables:
+      - ANTHROPIC_API_KEY
+      - GITLAB_TOKEN_OPENCODE
+      - GITLAB_HOST
+    ```
+
+        </details>
+
+Você pode consultar a [documentação dos agentes da CLI do GitLab](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) para instruções detalhadas.
+
+---
+
+### Exemplos
+
+Aqui estão alguns exemplos de como você pode usar o opencode no GitLab.
+
+:::tip
+Você pode configurar para usar uma frase de gatilho diferente de `@opencode`.
+:::
+
+- **Explicar um problema**
+
+  Adicione este comentário em um problema do GitLab.
+
+  ```
+  @opencode explain this issue
+  ```
+
+  O opencode lerá o problema e responderá com uma explicação clara.
+
+- **Corrigir um problema**
+
+  Em um problema do GitLab, diga:
+
+  ```
+  @opencode fix this
+  ```
+
+  O opencode criará um novo branch, implementará as alterações e abrirá uma solicitação de mesclagem com as alterações.
+
+- **Revisar solicitações de mesclagem**
+
+  Deixe o seguinte comentário em uma solicitação de mesclagem do GitLab.
+
+  ```
+  @opencode review this merge request
+  ```
+
+  O opencode revisará a solicitação de mesclagem e fornecerá feedback.