zugzbot 1.0.0 → 1.0.1

package/.utils/docs_opencode/formatters.md

@@ -1,142 +0,0 @@
-# Formateadores
-
-OpenCode utiliza formateadores específicos del idioma.
-
-OpenCode formatea automáticamente los archivos después de escribirlos o editarlos utilizando formateadores específicos del idioma. Esto garantiza que el código generado siga los estilos de código de su proyecto.
-
----
-
-## [Integrados](#integrados)
-
-OpenCode viene con varios formateadores integrados para lenguajes y marcos populares. A continuación se muestra una lista de los formateadores, las extensiones de archivo compatibles y los comandos u opciones de configuración que necesita.
- ````[más](https://prettier.io/docs/en/index.html)````[más](https://biomejs.dev/)````[más](https://clang.llvm.org/docs/ClangFormat.html)````````````````````````````````````````````[indicador de variable de entorno experimental](https://opencode.ai/docs/cli/#experimental)``
-
-| Formateador Extensiones Requisitos |
-| --- |
-| gofmt .go Comando gofmt disponible |
-| mix .ex, .exs, .eex, .heex, .leex, .neex, .sface Comando mix disponible |
-| prettier .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml y dependencia prettier en package.json |
-| biome .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml y biome.json(c) archivo de configuración |
-| zig .zig, .zon Comando zig disponible |
-| clang-format .c, .cpp, .h, .hpp, .ino y .clang-format archivo de configuración |
-| ktlint .kt, .kts Comando ktlint disponible |
-| ruff .py, .pyi Comando ruff disponible con configuración |
-| rustfmt .rs Comando rustfmt disponible |
-| cargo fmt .rs Comando cargo fmt disponible |
-| uv .py, .pyi Comando uv disponible |
-| rubocop .rb, .rake, .gemspec, .ru Comando rubocop disponible |
-| standardrb .rb, .rake, .gemspec, .ru Comando standardrb disponible |
-| htmlbeautifier .erb, .html.erb Comando htmlbeautifier disponible |
-| air .R Comando air disponible |
-| dart .dart Comando dart disponible |
-| dfmt .d Comando dfmt disponible |
-| ocamlformat .ml, .mli Comando ocamlformat disponible y archivo de configuración .ocamlformat |
-| terraform .tf, .tfvars Comando terraform disponible |
-| gleam .gleam Comando gleam disponible |
-| nixfmt .nix Comando nixfmt disponible |
-| shfmt .sh, .bash Comando shfmt disponible |
-| pint .php dependencia laravel/pint en composer.json |
-| oxfmt (Experimental) .js, .jsx, .ts, .tsx Dependencia de oxfmt en package.json y un |
-| ormolu .hs Comando ormolu disponible |
-
-
-Entonces, si su proyecto tiene `prettier` en su `package.json`, OpenCode lo usará automáticamente.
-
----
-
-## [Cómo funciona](#cómo-funciona)
-
-Cuando OpenCode escribe o edita un archivo:
-
-1. Comprueba la extensión del archivo con todos los formateadores habilitados.
-1. Ejecuta el comando de formateo apropiado en el archivo.
-1. Aplica los cambios de formato automáticamente.
-
-Este proceso ocurre en segundo plano, lo que garantiza que los estilos de su código se mantengan sin ningún paso manual.
-
----
-
-## [Configuración](#configuración)
-
-Puede personalizar los formateadores a través de la sección `formatter` en su configuración OpenCode.
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "formatter": {}
-}
-```
-
-Cada configuración del formateador admite lo siguiente:
- ``````````
-
-| Propiedad Tipo Descripción |
-| --- |
-| disabled booleano Establezca esto en true para deshabilitar el formateador |
-| command cadena[] El comando a ejecutar para formatear |
-| environment objeto Variables de entorno para configurar al ejecutar el formateador |
-| extensions cadena[] Extensiones de archivo que este formateador debería manejar |
-
-
-Veamos algunos ejemplos.
-
----
-
-### [Deshabilitar formateadores](#deshabilitar-formateadores)
-
-Para deshabilitar **todos** los formateadores globalmente, configure `formatter` en `false`:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "formatter": false
-}
-```
-
-Para deshabilitar un formateador **específico**, establezca `disabled` en `true`:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "formatter": {
-    "prettier": {
-      "disabled": true
-    }
-  }
-}
-```
-
----
-
-### [Formateadores personalizados](#formateadores-personalizados)
-
-Puede anular los formateadores integrados o agregar otros nuevos especificando el comando, las variables de entorno y las extensiones de archivo:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "formatter": {
-    "prettier": {
-      "command": ["npx", "prettier", "--write", "$FILE"],
-      "environment": {
-        "NODE_ENV": "development"
-      },
-      "extensions": [".js", ".ts", ".jsx", ".tsx"]
-    },
-    "custom-markdown-formatter": {
-      "command": ["deno", "fmt", "$FILE"],
-      "extensions": [".md"]
-    }
-  }
-}
-```
-
-El marcador de posición **`$FILE`** en el comando se reemplazará con la ruta al archivo que se está formateando.

package/.utils/docs_opencode/keybinds.md

@@ -1,205 +0,0 @@
-# Combinaciones de teclas
-
-Personaliza tus combinaciones de teclas.
-
-OpenCode tiene una lista de combinaciones de teclas que puede personalizar a través de `tui.json`.
-
-**File**: tui.json
-
-```json
-{
-  "$schema": "https://opencode.ai/tui.json",
-  "keybinds": {
-    "leader": "ctrl+x",
-    "app_exit": "ctrl+c,ctrl+d,q",
-    "editor_open": "e",
-    "theme_list": "t",
-    "sidebar_toggle": "b",
-    "scrollbar_toggle": "none",
-    "username_toggle": "none",
-    "status_view": "s",
-    "tool_details": "none",
-    "session_export": "x",
-    "session_new": "n",
-    "session_list": "l",
-    "session_timeline": "g",
-    "session_fork": "none",
-    "session_rename": "none",
-    "session_share": "none",
-    "session_unshare": "none",
-    "session_interrupt": "escape",
-    "session_compact": "c",
-    "session_child_first": "down",
-    "session_child_cycle": "right",
-    "session_child_cycle_reverse": "left",
-    "session_parent": "up",
-    "messages_page_up": "pageup,ctrl+alt+b",
-    "messages_page_down": "pagedown,ctrl+alt+f",
-    "messages_line_up": "ctrl+alt+y",
-    "messages_line_down": "ctrl+alt+e",
-    "messages_half_page_up": "ctrl+alt+u",
-    "messages_half_page_down": "ctrl+alt+d",
-    "messages_first": "ctrl+g,home",
-    "messages_last": "ctrl+alt+g,end",
-    "messages_next": "none",
-    "messages_previous": "none",
-    "messages_copy": "y",
-    "messages_undo": "u",
-    "messages_redo": "r",
-    "messages_last_user": "none",
-    "messages_toggle_conceal": "h",
-    "model_list": "m",
-    "model_cycle_recent": "f2",
-    "model_cycle_recent_reverse": "shift+f2",
-    "model_cycle_favorite": "none",
-    "model_cycle_favorite_reverse": "none",
-    "variant_cycle": "ctrl+t",
-    "variant_list": "none",
-    "command_list": "ctrl+p",
-    "agent_list": "a",
-    "agent_cycle": "tab",
-    "agent_cycle_reverse": "shift+tab",
-    "input_clear": "ctrl+c",
-    "input_paste": "ctrl+v",
-    "input_submit": "return",
-    "input_newline": "shift+return,ctrl+return,alt+return,ctrl+j",
-    "input_move_left": "left,ctrl+b",
-    "input_move_right": "right,ctrl+f",
-    "input_move_up": "up",
-    "input_move_down": "down",
-    "input_select_left": "shift+left",
-    "input_select_right": "shift+right",
-    "input_select_up": "shift+up",
-    "input_select_down": "shift+down",
-    "input_line_home": "ctrl+a",
-    "input_line_end": "ctrl+e",
-    "input_select_line_home": "ctrl+shift+a",
-    "input_select_line_end": "ctrl+shift+e",
-    "input_visual_line_home": "alt+a",
-    "input_visual_line_end": "alt+e",
-    "input_select_visual_line_home": "alt+shift+a",
-    "input_select_visual_line_end": "alt+shift+e",
-    "input_buffer_home": "home",
-    "input_buffer_end": "end",
-    "input_select_buffer_home": "shift+home",
-    "input_select_buffer_end": "shift+end",
-    "input_delete_line": "ctrl+shift+d",
-    "input_delete_to_line_end": "ctrl+k",
-    "input_delete_to_line_start": "ctrl+u",
-    "input_backspace": "backspace,shift+backspace",
-    "input_delete": "ctrl+d,delete,shift+delete",
-    "input_undo": "ctrl+-,super+z",
-    "input_redo": "ctrl+.,super+shift+z",
-    "input_word_forward": "alt+f,alt+right,ctrl+right",
-    "input_word_backward": "alt+b,alt+left,ctrl+left",
-    "input_select_word_forward": "alt+shift+f,alt+shift+right",
-    "input_select_word_backward": "alt+shift+b,alt+shift+left",
-    "input_delete_word_forward": "alt+d,alt+delete,ctrl+delete",
-    "input_delete_word_backward": "ctrl+w,ctrl+backspace,alt+backspace",
-    "history_previous": "up",
-    "history_next": "down",
-    "terminal_suspend": "ctrl+z",
-    "terminal_title_toggle": "none",
-    "tips_toggle": "h",
-    "display_thinking": "none"
-  }
-}
-```
-
----
-
-## [Tecla líder](#tecla-líder)
-
-OpenCode usa una tecla `leader` para la mayoría de las combinaciones de teclas. Esto evita conflictos en tu terminal.
-
-De forma predeterminada, `ctrl+x` es la tecla principal y la mayoría de las acciones requieren que primero presione la tecla principal y luego el acceso directo. Por ejemplo, para iniciar una nueva sesión, primero presione `ctrl+x` y luego presione `n`.
-
-No es necesario utilizar una tecla líder para las combinaciones de teclas, pero le recomendamos que lo haga.
-
----
-
-## [Desactivar combinación de teclas](#desactivar-combinación-de-teclas)
-
-Puede deshabilitar una combinación de teclas agregando la clave a `tui.json` con un valor de “none”.
-
-**File**: tui.json
-
-```json
-{
-  "$schema": "https://opencode.ai/tui.json",
-  "keybinds": {
-    "session_compact": "none"
-  }
-}
-```
-
----
-
-## [Atajos de mensajes de escritorio](#atajos-de-mensajes-de-escritorio)
-
-La entrada de solicitud de la aplicación de escritorio OpenCode admite atajos comunes de estilo Readline/Emacs para editar texto. Estos están integrados y actualmente no se pueden configurar a través de `opencode.json`.
- ``````````````````````````
-
-| Atajo Acción |
-| --- |
-| ctrl+a Mover al inicio de la línea actual |
-| ctrl+e Mover al final de la línea actual |
-| ctrl+b Mover el cursor hacia atrás un carácter |
-| ctrl+f Mover el cursor hacia adelante un carácter |
-| alt+b Mover el cursor hacia atrás una palabra |
-| alt+f Mover el cursor hacia adelante una palabra |
-| ctrl+d Eliminar carácter debajo del cursor |
-| ctrl+k Borrar hasta el final de la línea |
-| ctrl+u Borrar al inicio de la línea |
-| ctrl+w Borrar palabra anterior |
-| alt+d Borrar la siguiente palabra |
-| ctrl+t Transponer caracteres |
-| ctrl+g Cancelar ventanas emergentes/abortar la respuesta en ejecución |
-
-
----
-
-## [Mayús+Entrar](#mayúsentrar)
-
-Algunos terminales no envían teclas modificadoras con Enter de forma predeterminada. Es posible que necesite configurar su terminal para enviar `Shift+Enter` como secuencia de escape.
-
-### [Windows Terminal](#windows-terminal)
-
-Abra su `settings.json` en:
-
-**File**:
-
-```plaintext
-%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
-```
-
-Agregue esto a la matriz `actions` de nivel raíz:
-
-**File**:
-
-```json
-"actions": [
-  {
-    "command": {
-      "action": "sendInput",
-      "input": "\u001b[13;2u"
-    },
-    "id": "User.sendInput.ShiftEnterCustom"
-  }
-]
-```
-
-Agregue esto a la matriz `keybindings` de nivel raíz:
-
-**File**:
-
-```json
-"keybindings": [
-  {
-    "keys": "shift+enter",
-    "id": "User.sendInput.ShiftEnterCustom"
-  }
-]
-```
-
-Guarde el archivo y reinicie Windows Terminal o abra una nueva pestaña.

package/.utils/docs_opencode/lsp.md

@@ -1,202 +0,0 @@
-# Servidores LSP
-
-OpenCode se integra con sus servidores LSP.
-
-OpenCode se integra con su protocolo de servidor de idiomas (LSP) para ayudar a LLM a interactuar con su código base. Utiliza diagnósticos para proporcionar retroalimentación al LLM.
-
----
-
-## [Incorporados](#incorporados)
-
-OpenCode viene con varios servidores LSP integrados para idiomas populares:
- ``````````````````````````````````````````````````
-
-| Servidor LSP Extensiones Requisitos |
-| --- |
-| astro .astro Autoinstalaciones para proyectos Astro |
-| bash .sh, .bash, .zsh, .ksh Autoinstala el servidor en lenguaje bash |
-| clangd .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ Instalaciones automáticas para proyectos C/C++ |
-| csharp .cs .NET SDK instalado |
-| clojure-lsp .clj, .cljs, .cljc, .edn Comando clojure-lsp disponible |
-| dart .dart Comando dart disponible |
-| deno .ts, .tsx, .js, .jsx, .mjs Comando deno disponible (detecta automáticamente deno.json/deno.jsonc) |
-| elixir-ls .ex, .exs Comando elixir disponible |
-| eslint .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue eslint dependencia en proyecto |
-| fsharp .fs, .fsi, .fsx, .fsscript .NET SDK instalado |
-| gleam .gleam Comando gleam disponible |
-| gopls .go Comando go disponible |
-| hls .hs, .lhs Comando haskell-language-server-wrapper disponible |
-| jdtls .java Java SDK (version 21+) instalado |
-| julials .jl julia y LanguageServer.jl instalados |
-| kotlin-ls .kt, .kts Autoinstalaciones para proyectos Kotlin |
-| lua-ls .lua Autoinstalaciones para proyectos Lua |
-| nixd .nix Comando nixd disponible |
-| ocaml-lsp .ml, .mli Comando ocamllsp disponible |
-| oxlint .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte oxlint dependencia en proyecto |
-| php intelephense .php Autoinstalaciones para proyectos PHP |
-| prisma .prisma Comando prisma disponible |
-| pyright .py, .pyi Dependencia pyright instalada |
-| ruby-lsp (rubocop) .rb, .rake, .gemspec, .ru Comandos ruby y gem disponibles |
-| rust .rs Comando rust-analyzer disponible |
-| sourcekit-lsp .swift, .objc, .objcpp swift instalado ( xcode en macOS) |
-| svelte .svelte Autoinstalaciones para proyectos Svelte |
-| terraform .tf, .tfvars Instalaciones automáticas desde versiones GitHub |
-| tinymist .typ, .typc Instalaciones automáticas desde versiones GitHub |
-| typescript .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts typescript dependencia en proyecto |
-| vue .vue Autoinstalaciones para proyectos Vue |
-| yaml-ls .yaml, .yml Autoinstala Red Hat yaml-language-server |
-| zls .zig, .zon Comando zig disponible |
-
-
-Los servidores LSP se habilitan automáticamente cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.
-
-> [!NOTE]
-> Puede deshabilitar las descargas automáticas del servidor LSP configurando la variable de entorno `OPENCODE_DISABLE_LSP_DOWNLOAD` en `true`.
-
----
-
-## [Cómo funciona](#cómo-funciona)
-
-Cuando opencode abre un archivo:
-
-1. Comprueba la extensión del archivo con todos los servidores LSP habilitados.
-1. Inicia el servidor LSP apropiado si aún no se está ejecutando.
-
----
-
-## [Configuración](#configuración)
-
-Puede personalizar los servidores LSP a través de la sección `lsp` en su configuración opencode.
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "lsp": {}
-}
-```
-
-Cada servidor LSP admite lo siguiente:
- ````````````
-
-| Propiedad Tipo Descripción |
-| --- |
-| disabled booleano Establezca esto en true para deshabilitar el servidor LSP |
-| command cadena[] El comando para iniciar el servidor LSP |
-| extensions cadena[] Extensiones de archivo que este servidor LSP debería manejar |
-| env objeto Variables de entorno para configurar al iniciar el servidor |
-| initialization objeto Opciones de inicialización para enviar al servidor LSP |
-
-
-Veamos algunos ejemplos.
-
----
-
-### [Variables de entorno](#variables-de-entorno)
-
-Utilice la propiedad `env` para establecer variables de entorno al iniciar el servidor LSP:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "lsp": {
-    "rust": {
-      "env": {
-        "RUST_LOG": "debug"
-      }
-    }
-  }
-}
-```
-
----
-
-### [Opciones de inicialización](#opciones-de-inicialización)
-
-Utilice la propiedad `initialization` para pasar opciones de inicialización al servidor LSP. Estas son configuraciones específicas del servidor enviadas durante la solicitud LSP `initialize`:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "lsp": {
-    "typescript": {
-      "initialization": {
-        "preferences": {
-          "importModuleSpecifierPreference": "relative"
-        }
-      }
-    }
-  }
-}
-```
-
-> [!NOTE]
-> Las opciones de inicialización varían según el servidor LSP. Consulte la documentación de su servidor LSP para conocer las opciones disponibles.
-
----
-
-### [Deshabilitar servidores LSP](#deshabilitar-servidores-lsp)
-
-Para deshabilitar **todos** los servidores LSP globalmente, configure `lsp` en `false`:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "lsp": false
-}
-```
-
-Para deshabilitar un servidor LSP **específico**, configure `disabled` en `true`:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "lsp": {
-    "typescript": {
-      "disabled": true
-    }
-  }
-}
-```
-
----
-
-### [Servidores LSP personalizados](#servidores-lsp-personalizados)
-
-Puede agregar servidores LSP personalizados especificando el comando y las extensiones de archivo:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "lsp": {
-    "custom-lsp": {
-      "command": ["custom-lsp-server", "--stdio"],
-      "extensions": [".custom"]
-    }
-  }
-}
-```
-
----
-
-## [Información adicional](#información-adicional)
-
-### [PHP Intelephense](#php-intelephense)
-
-PHP Intelephense ofrece funciones premium a través de una clave de licencia. Puede proporcionar una clave de licencia colocando (únicamente) la clave en un archivo de texto en:
-
-- En macOS/Linux: `$HOME/intelephense/license.txt`
-- En Windows: `%USERPROFILE%/intelephense/license.txt`
-
-El archivo debe contener sólo la clave de licencia sin contenido adicional.