zugzbot 1.0.21 → 1.0.23

package/.utils/docs_opencode/plugins.md

@@ -1,409 +0,0 @@
-# Complementos
-
-Escriba sus propios complementos para extender OpenCode.
-
-Los complementos le permiten extender OpenCode al conectarse a varios eventos y personalizar el comportamiento. Puede crear complementos para agregar nuevas funciones, integrarlos con servicios externos o modificar el comportamiento predeterminado de OpenCode.
-
-Para ver ejemplos, consulte los [complementos](https://opencode.ai/docs/ecosystem#plugins) creados por la comunidad.
-
----
-
-## [Usar un complemento](#usar-un-complemento)
-
-Hay dos formas de cargar complementos.
-
----
-
-### [Desde archivos locales](#desde-archivos-locales)
-
-Coloque los archivos JavaScript o TypeScript en el directorio del complemento.
-
-- `.opencode/plugins/` - Complementos a nivel de proyecto
-- `~/.config/opencode/plugins/` - Complementos globales
-
-Los archivos en estos directorios se cargan automáticamente al inicio.
-
----
-
-### [Desde npm](#desde-npm)
-
-Especifique paquetes npm en su archivo de configuración.
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-helicone-session", "opencode-wakatime", "@my-org/custom-plugin"]
-}
-```
-
-Se admiten paquetes npm regulares y de alcance.
-
-Explore los complementos disponibles en el [ecosistema](https://opencode.ai/docs/ecosystem#plugins).
-
----
-
-### [Cómo se instalan los complementos](#cómo-se-instalan-los-complementos)
-
-Los **complementos npm** se instalan automáticamente usando Bun al inicio. Los paquetes y sus dependencias se almacenan en caché en `~/.cache/opencode/node_modules/`.
-
-**Los complementos locales** se cargan directamente desde el directorio de complementos. Para usar paquetes externos, debe crear un `package.json` dentro de su directorio de configuración (consulte [Dependencias](#dependencies)), o publicar el complemento en npm y [agregarlo a su configuración](https://opencode.ai/docs/config#plugins).
-
----
-
-### [Orden de carga](#orden-de-carga)
-
-Los complementos se cargan desde todas las fuentes y todos los enlaces se ejecutan en secuencia. El orden de carga es:
-
-1. Configuración global (`~/.config/opencode/opencode.json`)
-1. Configuración del proyecto (`opencode.json`)
-1. Directorio global de complementos (`~/.config/opencode/plugins/`)
-1. Directorio de complementos del proyecto (`.opencode/plugins/`)
-
-Los paquetes npm duplicados con el mismo nombre y versión se cargan una vez. Sin embargo, un complemento local y un complemento npm con nombres similares se cargan por separado.
-
----
-
-## [Crear un complemento](#crear-un-complemento)
-
-Un complemento es un módulo **JavaScript/TypeScript** que exporta uno o más complementos. funciones. Cada función recibe un objeto de contexto y devuelve un objeto de enlace.
-
----
-
-### [Dependencias](#dependencias)
-
-Los complementos locales y las herramientas personalizadas pueden utilizar paquetes npm externos. Agregue un `package.json` a su directorio de configuración con las dependencias que necesita.
-
-**File**: .opencode/package.json
-
-```json
-{
-  "dependencies": {
-    "shescape": "^2.1.0"
-  }
-}
-```
-
-OpenCode ejecuta `bun install` al inicio para instalarlos. Luego, sus complementos y herramientas pueden importarlos.
-
-**File**: .opencode/plugins/my-plugin.ts
-
-```ts
-import { escape } from "shescape"
-
-export const MyPlugin = async (ctx) => {
-  return {
-    "tool.execute.before": async (input, output) => {
-      if (input.tool === "bash") {
-        output.args.command = escape(output.args.command)
-      }
-    },
-  }
-}
-```
-
----
-
-### [Estructura básica](#estructura-básica)
-
-**File**: .opencode/plugins/example.js
-
-```js
-export const MyPlugin = async ({ project, client, $, directory, worktree }) => {
-  console.log("Plugin initialized!")
-
-  return {
-    // Hook implementations go here
-  }
-}
-```
-
-La función del complemento recibe:
-
-- `project`: La información actual del proyecto.
-- `directory`: El directorio de trabajo actual.
-- `worktree`: La ruta del árbol de trabajo de git.
-- `client`: Un cliente SDK opencode para interactuar con la IA.
-- `$`: [shell API](https://bun.com/docs/runtime/shell) de Bun para ejecutar comandos.
-
----
-
-### [Soporte TypeScript](#soporte-typescript)
-
-Para los complementos TypeScript, puede importar tipos desde el paquete de complementos:
-
-**File**: my-plugin.ts
-
-```ts
-import type { Plugin } from "@opencode-ai/plugin"
-
-export const MyPlugin: Plugin = async ({ project, client, $, directory, worktree }) => {
-  return {
-    // Type-safe hook implementations
-  }
-}
-```
-
----
-
-### [Eventos](#eventos)
-
-Los complementos pueden suscribirse a eventos como se ve a continuación en la sección Ejemplos. Aquí hay una lista de los diferentes eventos disponibles.
-
-#### [Eventos de comando](#eventos-de-comando)
-
-- `command.executed`
-
-#### [Eventos de archivo](#eventos-de-archivo)
-
-- `file.edited`
-- `file.watcher.updated`
-
-#### [Eventos de instalación](#eventos-de-instalación)
-
-- `installation.updated`
-
-#### [Eventos LSP](#eventos-lsp)
-
-- `lsp.client.diagnostics`
-- `lsp.updated`
-
-#### [Eventos de mensajes](#eventos-de-mensajes)
-
-- `message.part.removed`
-- `message.part.updated`
-- `message.removed`
-- `message.updated`
-
-#### [Eventos de permiso](#eventos-de-permiso)
-
-- `permission.asked`
-- `permission.replied`
-
-#### [Eventos del servidor](#eventos-del-servidor)
-
-- `server.connected`
-
-#### [Eventos de sesión](#eventos-de-sesión)
-
-- `session.created`
-- `session.compacted`
-- `session.deleted`
-- `session.diff`
-- `session.error`
-- `session.idle`
-- `session.status`
-- `session.updated`
-
-#### [Eventos de Todo](#eventos-de-todo)
-
-- `todo.updated`
-
-#### [Eventos de Shell](#eventos-de-shell)
-
-- `shell.env`
-
-#### [Eventos de herramientas](#eventos-de-herramientas)
-
-- `tool.execute.after`
-- `tool.execute.before`
-
-#### [Eventos TUI](#eventos-tui)
-
-- `tui.prompt.append`
-- `tui.command.execute`
-- `tui.toast.show`
-
----
-
-## [Ejemplos](#ejemplos)
-
-A continuación se muestran algunos ejemplos de complementos que puede utilizar para ampliar opencode.
-
----
-
-### [Enviar notificaciones](#enviar-notificaciones)
-
-Enviar notificaciones cuando ocurran ciertos eventos:
-
-**File**: .opencode/plugins/notification.js
-
-```js
-export const NotificationPlugin = async ({ project, client, $, directory, worktree }) => {
-  return {
-    event: async ({ event }) => {
-      // Send notification on session completion
-      if (event.type === "session.idle") {
-        await $`osascript -e 'display notification "Session completed!" with title "opencode"'`
-      }
-    },
-  }
-}
-```
-
-Estamos usando `osascript` para ejecutar AppleScript en macOS. Aquí lo estamos usando para enviar notificaciones.
-
-> [!NOTE]
-> Si está utilizando la aplicación de escritorio OpenCode, puede enviar notificaciones del sistema automáticamente cuando una respuesta esté lista o cuando se produzca un error en una sesión.
-
----
-
-### [Protección .env](#protección-env)
-
-Evite que opencode lea archivos `.env`:
-
-**File**: .opencode/plugins/env-protection.js
-
-```javascript
-export const EnvProtection = async ({ project, client, $, directory, worktree }) => {
-  return {
-    "tool.execute.before": async (input, output) => {
-      if (input.tool === "read" && output.args.filePath.includes(".env")) {
-        throw new Error("Do not read .env files")
-      }
-    },
-  }
-}
-```
-
----
-
-### [Inyectar variables de entorno](#inyectar-variables-de-entorno)
-
-Inyecte variables de entorno en toda la ejecución del shell (herramientas de inteligencia artificial y terminales de usuario):
-
-**File**: .opencode/plugins/inject-env.js
-
-```javascript
-export const InjectEnvPlugin = async () => {
-  return {
-    "shell.env": async (input, output) => {
-      output.env.MY_API_KEY = "secret"
-      output.env.PROJECT_ROOT = input.cwd
-    },
-  }
-}
-```
-
----
-
-### [Herramientas personalizadas](#herramientas-personalizadas)
-
-Los complementos también pueden agregar herramientas personalizadas a opencode:
-
-**File**: .opencode/plugins/custom-tools.ts
-
-```ts
-import { type Plugin, tool } from "@opencode-ai/plugin"
-
-export const CustomToolsPlugin: Plugin = async (ctx) => {
-  return {
-    tool: {
-      mytool: tool({
-        description: "This is a custom tool",
-        args: {
-          foo: tool.schema.string(),
-        },
-        async execute(args, context) {
-          const { directory, worktree } = context
-          return `Hello ${args.foo} from ${directory} (worktree: ${worktree})`
-        },
-      }),
-    },
-  }
-}
-```
-
-El ayudante `tool` crea una herramienta personalizada a la que opencode puede llamar. Toma una función de esquema Zod y devuelve una definición de herramienta con:
-
-- `description`: Qué hace la herramienta
-- `args`: Esquema Zod para los argumentos de la herramienta.
-- `execute`: Función que se ejecuta cuando se llama a la herramienta
-
-Sus herramientas personalizadas estarán disponibles para opencode junto con las herramientas integradas.
-
-> [!NOTE]
-> Si una herramienta de complemento utiliza el mismo nombre que una herramienta integrada, la herramienta de complemento tiene prioridad.
-
----
-
-### [Registro](#registro)
-
-Utilice `client.app.log()` en lugar de `console.log` para el registro estructurado:
-
-**File**: .opencode/plugins/my-plugin.ts
-
-```ts
-export const MyPlugin = async ({ client }) => {
-  await client.app.log({
-    body: {
-      service: "my-plugin",
-      level: "info",
-      message: "Plugin initialized",
-      extra: { foo: "bar" },
-    },
-  })
-}
-```
-
-Niveles: `debug`, `info`, `warn`, `error`. Consulte la [documentación del SDK](https://opencode.ai/docs/sdk) para obtener más detalles.
-
----
-
-### [Hooks de compactación](#hooks-de-compactación)
-
-Personalice el contexto incluido cuando se compacta una sesión:
-
-**File**: .opencode/plugins/compaction.ts
-
-```ts
-import type { Plugin } from "@opencode-ai/plugin"
-
-export const CompactionPlugin: Plugin = async (ctx) => {
-  return {
-    "experimental.session.compacting": async (input, output) => {
-      // Inject additional context into the compaction prompt
-      output.context.push(`
-## Custom Context
-
-Include any state that should persist across compaction:
-- Current task status
-- Important decisions made
-- Files being actively worked on
-`)
-    },
-  }
-}
-```
-
-El hook `experimental.session.compacting` se activa antes de que LLM genere un resumen de continuación. Úselo para inyectar contexto específico del dominio que el mensaje de compactación predeterminado omitiría.
-
-También puede reemplazar completamente el mensaje de compactación configurando `output.prompt`:
-
-**File**: .opencode/plugins/custom-compaction.ts
-
-```ts
-import type { Plugin } from "@opencode-ai/plugin"
-
-export const CustomCompactionPlugin: Plugin = async (ctx) => {
-  return {
-    "experimental.session.compacting": async (input, output) => {
-      // Replace the entire compaction prompt
-      output.prompt = `
-You are generating a continuation prompt for a multi-agent swarm session.
-
-Summarize:
-1. The current task and its status
-2. Which files are being modified and by whom
-3. Any blockers or dependencies between agents
-4. The next steps to complete the work
-
-Format as a structured prompt that a new agent can use to resume work.
-`
-    },
-  }
-}
-```
-
-Cuando se configura `output.prompt`, reemplaza completamente el mensaje de compactación predeterminado. En este caso, se ignora la matriz `output.context`.

package/.utils/docs_opencode/rules.md

@@ -1,189 +0,0 @@
-# Reglas
-
-Establezca instrucciones personalizadas para opencode.
-
-Puede proporcionar instrucciones personalizadas a opencode creando un archivo `AGENTS.md`. Esto es similar a las reglas del Cursor. Contiene instrucciones que se incluirán en el contexto de LLM para personalizar su comportamiento para su proyecto específico.
-
----
-
-## [Inicializar](#inicializar)
-
-Para crear un nuevo archivo `AGENTS.md`, puede ejecutar el comando `/init` en opencode.
-
-> [!TIP]
-> Debes enviar el archivo `AGENTS.md` de tu proyecto a Git.
-
-Esto escaneará su proyecto y todo su contenido para comprender de qué se trata y generar un archivo `AGENTS.md` con él. Esto ayuda a opencode a navegar mejor por el proyecto.
-
-Si tiene un archivo `AGENTS.md` existente, intentará agregarlo.
-
----
-
-## [Ejemplo](#ejemplo)
-
-También puedes crear este archivo manualmente. A continuación se muestra un ejemplo de algunas cosas que puede colocar en un archivo `AGENTS.md`.
-
-**File**: AGENTS.md
-
-```markdown
-# SST v3 Monorepo Project
-
-This is an SST v3 monorepo with TypeScript. The project uses bun workspaces for package management.
-
-## Project Structure
-
-- `packages/` - Contains all workspace packages (functions, core, web, etc.)
-- `infra/` - Infrastructure definitions split by service (storage.ts, api.ts, web.ts)
-- `sst.config.ts` - Main SST configuration with dynamic imports
-
-## Code Standards
-
-- Use TypeScript with strict mode enabled
-- Shared code goes in `packages/core/` with proper exports configuration
-- Functions go in `packages/functions/`
-- Infrastructure should be split into logical files in `infra/`
-
-## Monorepo Conventions
-
-- Import shared modules using workspace names: `@my-app/core/example`
-```
-
-Estamos agregando instrucciones específicas del proyecto aquí y esto se compartirá con todo su equipo.
-
----
-
-## [Tipos](#tipos)
-
-opencode también admite la lectura del archivo `AGENTS.md` desde múltiples ubicaciones. Y esto tiene diferentes propósitos.
-
-### [Proyecto](#proyecto)
-
-Coloque un `AGENTS.md` en la raíz de su proyecto para reglas específicas del proyecto. Estos solo se aplican cuando trabaja en este directorio o sus subdirectorios.
-
-### [Global](#global)
-
-También puedes tener reglas globales en un archivo `~/.config/opencode/AGENTS.md`. Esto se aplica en todas las sesiones opencode.
-
-Dado que esto no está comprometido con Git ni se comparte con su equipo, recomendamos usarlo para especificar las reglas personales que debe seguir LLM.
-
-### [Compatibilidad con Claude Code](#compatibilidad-con-claude-code)
-
-Para los usuarios que migran desde Claude Code, OpenCode admite las convenciones de archivos de Claude Code como alternativas:
-
-- **Reglas del proyecto**: `CLAUDE.md` en el directorio de tu proyecto (se usa si no existe `AGENTS.md`)
-- **Reglas globales**: `~/.claude/CLAUDE.md` (se usa si no existe `~/.config/opencode/AGENTS.md`)
-- **Habilidades**: `~/.claude/skills/`; consulte [Habilidades del agente](https://opencode.ai/docs/skills/) para obtener más detalles.
-
-Para deshabilitar la compatibilidad de Claude Code, configure una de estas variables de entorno:
-
-**File**: Ventana de terminal
-
-```bash
-export OPENCODE_DISABLE_CLAUDE_CODE=1        # Disable all .claude support
-export OPENCODE_DISABLE_CLAUDE_CODE_PROMPT=1 # Disable only ~/.claude/CLAUDE.md
-export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
-```
-
----
-
-## [Prioridad](#prioridad)
-
-Cuando se inicia opencode, busca archivos de reglas en este orden:
-
-1. **Archivos locales** atravesando desde el directorio actual (`AGENTS.md`, `CLAUDE.md`)
-1. **Archivo global** en `~/.config/opencode/AGENTS.md`
-1. **Archivo de Claude Code** en `~/.claude/CLAUDE.md` (a menos que esté deshabilitado)
-
-El primer archivo coincidente gana en cada categoría. Por ejemplo, si tiene `AGENTS.md` y `CLAUDE.md`, solo se usa `AGENTS.md`. De manera similar, `~/.config/opencode/AGENTS.md` tiene prioridad sobre `~/.claude/CLAUDE.md`.
-
----
-
-## [Instrucciones personalizadas](#instrucciones-personalizadas)
-
-Puede especificar archivos de instrucciones personalizados en su `opencode.json` o el `~/.config/opencode/opencode.json` global. Esto le permite a usted y a su equipo reutilizar las reglas existentes en lugar de tener que duplicarlas en AGENTS.md.
-
-Ejemplo:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
-}
-```
-
-También puede utilizar URL remotas para cargar instrucciones desde la web.
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
-}
-```
-
-Las instrucciones remotas se recuperan con un tiempo de espera de 5 segundos.
-
-Todos los archivos de instrucciones se combinan con sus archivos `AGENTS.md`.
-
----
-
-## [Hacer referencia a archivos externos](#hacer-referencia-a-archivos-externos)
-
-Si bien opencode no analiza automáticamente las referencias de archivos en `AGENTS.md`, puedes lograr una funcionalidad similar de dos maneras:
-
-### [Usar opencode.json](#usar-opencodejson)
-
-El enfoque recomendado es utilizar el campo `instructions` en `opencode.json`:
-
-**File**: opencode.json
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
-}
-```
-
-### [Instrucciones manuales en AGENTS.md](#instrucciones-manuales-en-agentsmd)
-
-Puede enseñarle a opencode a leer archivos externos proporcionando instrucciones explícitas en su `AGENTS.md`. He aquí un ejemplo práctico:
-
-**File**: AGENTS.md
-
-```markdown
-# TypeScript Project Rules
-
-## External File Loading
-
-CRITICAL: When you encounter a file reference (e.g., @rules/general.md), use your Read tool to load it on a need-to-know basis. They're relevant to the SPECIFIC task at hand.
-
-Instructions:
-
-- Do NOT preemptively load all references - use lazy loading based on actual need
-- When loaded, treat content as mandatory instructions that override defaults
-- Follow references recursively when needed
-
-## Development Guidelines
-
-For TypeScript code style and best practices: @docs/typescript-guidelines.md
-For React component architecture and hooks patterns: @docs/react-patterns.md
-For REST API design and error handling: @docs/api-standards.md
-For testing strategies and coverage requirements: @test/testing-guidelines.md
-
-## General Guidelines
-
-Read the following file immediately as it's relevant to all workflows: @rules/general-guidelines.md.
-```
-
-Este enfoque le permite:
-
-- Crear archivos de reglas modulares y reutilizables
-- Compartir reglas entre proyectos a través de enlaces simbólicos o submódulos de git
-- Mantenga AGENTS.md conciso mientras hace referencia a pautas detalladas
-- Asegúrese de que opencode cargue archivos solo cuando sea necesario para la tarea específica
-
-> [!TIP]
-> Para monorepos o proyectos con estándares compartidos, usar `opencode.json` con patrones globales (como `packages/*/AGENTS.md`) es más fácil de mantener que las instrucciones manuales.