amplifthq/opentag

¿Qué hace opentag?

OpenTag convierte menciones del espacio de trabajo como @opentag arregla esto en ejecuciones auditables de agentes. Usa esta habilidad para ayudar a un usuario a configurar el camino desde el evento del espacio de trabajo hasta el despachador, ejecutor local, ejecutor y callback.

Enrutar la Solicitud

Lee solo la referencia necesaria para la ruta del usuario:

• Prueba local rápida o primera configuración: references/local-echo.md
• Menciones en issues o PRs de GitHub: references/github-setup.md
• Menciones en la app de Slack: references/slack-setup.md
• Ejecución real de código o creación de PRs: references/codex-runner.md
• Ejecuciones fallidas, callbacks faltantes, ejecuciones rechazadas o errores de autenticación: references/troubleshooting.md

Si el usuario solicita más de una ruta, configura y verifica primero el bucle funcional más pequeño, luego agrega el siguiente adaptador.

Reglas de Trabajo

• Prefiere el bucle de eco local antes que agentes reales o callbacks en vivo, a menos que el usuario ya tenga un despachador y ejecutor funcionales.
• Mantén la configuración explícita: no inventes propietarios de repositorios, nombres de repos, rutas de checkout, tokens, IDs de Slack o URLs de despachador.
• No agregues comportamiento de respaldo. Los valores obligatorios faltantes deben detener la configuración con una lista clara de lo que falta.
• Trata opentagd como la autoridad de ejecución local. Solo debe reclamar los repositorios listados en su configuración.
• Usa echo para pruebas no destructivas de humo y codex solo cuando el usuario quiera ejecución real de código.
• Separa las capas de prueba: salud del despachador, registro del ejecutor, vinculación de repositorios o Slack, creación de ejecuciones, ejecución del daemon y entrega de callbacks.

Flujo de Trabajo de Configuración

1. Identifica el bucle objetivo. Finalización: se nombra un bucle: local-echo, github, slack o codex-runner.

2. Recopila los hechos requeridos. Finalización: la respuesta incluye cada valor faltante, o todos los valores requeridos están disponibles.

3. Escribe o actualiza la configuración mínima. Finalización: la configuración contiene solo los campos necesarios para el bucle seleccionado y usa el repositorio/canal/checkouts reales del usuario.

4. Registra las vinculaciones antes de crear ejecuciones. Finalización: el ejecutor está registrado, los repositorios están vinculados y los canales de Slack están vinculados cuando Slack está en el alcance.

5. Verifica una ejecución real. Finalización: la ejecución es visible a través del despachador, tiene eventos de auditoría y termina como completada o falla con un error específico.

6. Reporta el resultado. Finalización: dile al usuario qué se configuró, qué comando lo probó y qué queda sin configurar.

Valores por Defecto de Comandos

Usa estos valores por defecto a menos que el proyecto haya cambiado:

• Aplicación despachadora: pnpm --filter @opentag/dispatcher-app dev
• Aplicación daemon local: pnpm --filter @opentag/opentagd dev -- <comando>
• Aplicación de eventos de Slack: pnpm --filter @opentag/slack-events dev
• URL del despachador: http://localhost:3030
• Ruta de URL de eventos de Slack: /slack/events
• Carga útil de ejemplo de ejecución: examples/github-to-echo/run.example.json

Antes de ejecutar comandos de paquetes en este repositorio, usa Node 22.x e instala las dependencias si es necesario.