egutierrez
892fe0cb19
Mover issue 0033-bot-commands-no-prefix a completed/. Todas las tareas implementadas y tests pasando.
118 lines
5.4 KiB
Markdown
118 lines
5.4 KiB
Markdown
# 0033 — Comandos de robots sin prefijo !
|
|
|
|
## Objetivo
|
|
|
|
Permitir que los robots respondan a comandos sin necesitar el prefijo `!`. Actualmente los bots requieren `!help`, `!ping`, etc. El objetivo es que un robot pueda configurar sus comandos para que funcionen tambien sin prefijo: `help`, `ping`, `status`.
|
|
|
|
Esto es especialmente util para robots interactivos donde el prefijo `!` es friccion innecesaria — los robots solo responden comandos, asi que todo mensaje es potencialmente un comando.
|
|
|
|
## Contexto
|
|
|
|
- Los robots (`agent.type: robot`) solo responden a comandos, no tienen LLM
|
|
- El sistema de comandos actual en `agents/handler.go` parsea el prefijo `!` en `shell/matrix/listener.go`
|
|
- El campo `matrix.filters.command_prefix` ya existe en el config pero esta hardcoded a `!`
|
|
- Los agentes con LLM necesitan el prefijo para distinguir comandos de mensajes normales
|
|
- Los robots NO necesitan esta distincion — todo mensaje a un robot es un comando o se ignora
|
|
|
|
## Arquitectura
|
|
|
|
```
|
|
shell/matrix/listener.go MOD — parsear comandos con o sin prefijo segun config
|
|
pkg/decision/types.go MOD — asegurar que Command se popula sin prefijo
|
|
agents/handler.go MOD — routing de comandos: si robot y sin prefijo, intentar match
|
|
agents/robot.go MOD — handleEvent acepta comandos sin prefijo
|
|
internal/config/schema.go MOD — documentar command_prefix: "" como "sin prefijo"
|
|
agents/_template_robot/config.yaml MOD — ejemplo con command_prefix: ""
|
|
```
|
|
|
|
### Patron pure core / impure shell
|
|
|
|
- `pkg/decision/types.go` — puro: solo tipos, MessageContext ya tiene campo Command
|
|
- `shell/matrix/listener.go` — impuro: parseo del evento Matrix, detectar comando con/sin prefijo
|
|
- `agents/robot.go` + `agents/handler.go` — composicion: routing de comandos
|
|
|
|
### Comportamiento esperado
|
|
|
|
| Config | Mensaje | Resultado |
|
|
|--------|---------|-----------|
|
|
| `command_prefix: "!"` | `!help` | Ejecuta help |
|
|
| `command_prefix: "!"` | `help` | Ignora (sin prefijo) |
|
|
| `command_prefix: ""` | `help` | Ejecuta help |
|
|
| `command_prefix: ""` | `!help` | Ejecuta help (retrocompatible) |
|
|
| `command_prefix: ""` | `hola mundo` | "Comando desconocido: hola" |
|
|
|
|
Cuando `command_prefix` es vacio:
|
|
- El primer token del mensaje se trata como nombre de comando
|
|
- Si el primer token empieza con `!`, se le quita el prefijo y se busca igual
|
|
- Si no hay match, responder "Comando desconocido" (comportamiento actual)
|
|
|
|
## Tareas
|
|
|
|
### Fase 1: Parser de comandos flexible
|
|
|
|
- [ ] **1.1** Modificar `shell/matrix/listener.go` — al parsear el evento, si `command_prefix` es vacio, tratar el primer token como comando (sin requerir `!`). Si tiene prefijo `!`, quitarlo igualmente para retrocompatibilidad.
|
|
- [ ] **1.2** Asegurar que `MessageContext.Command` se popula correctamente en ambos modos.
|
|
- [ ] **1.3** NO cambiar el comportamiento para agentes con LLM (`type: agent`) — solo afecta cuando `command_prefix: ""`.
|
|
|
|
### Fase 2: Routing en robot
|
|
|
|
- [ ] **2.1** Verificar que `agents/robot.go` ya maneja correctamente el campo `Command` de MessageContext — no deberia necesitar cambios si el parser hace bien su trabajo.
|
|
- [ ] **2.2** Si es necesario, ajustar `handleEvent` en robot para aceptar comandos sin prefijo.
|
|
|
|
### Fase 3: Config y template
|
|
|
|
- [ ] **3.1** Documentar en `internal/config/schema.go` que `command_prefix: ""` significa "sin prefijo".
|
|
- [ ] **3.2** Actualizar `agents/_template_robot/config.yaml` para mostrar `command_prefix: ""` como opcion comentada.
|
|
|
|
### Fase 4: Tests
|
|
|
|
- [ ] **4.1** Tests unitarios para el parser de comandos: con prefijo `!`, sin prefijo, prefijo vacio en config.
|
|
- [ ] **4.2** Tests para robot handleEvent con comandos sin prefijo.
|
|
- [ ] **4.3** Tests de regresion: verificar que agentes con LLM siguen funcionando igual con `command_prefix: "!"`.
|
|
- [ ] **4.4** `go build -tags goolm ./...` y `go test -tags goolm ./...`
|
|
|
|
### Fase 5: Cleanup
|
|
|
|
- [ ] **5.1** Actualizar `.claude/rules/create_command.md` mencionando la opcion sin prefijo para robots.
|
|
|
|
## Ejemplo de uso
|
|
|
|
```yaml
|
|
# config.yaml del robot
|
|
agent:
|
|
type: robot
|
|
matrix:
|
|
filters:
|
|
command_prefix: "" # sin prefijo — todo mensaje es potencial comando
|
|
```
|
|
|
|
```
|
|
Usuario: help
|
|
Bot: Comandos disponibles: help, ping, status, info, version
|
|
|
|
Usuario: ping
|
|
Bot: pong (latencia: 23ms)
|
|
|
|
Usuario: !help # retrocompatible
|
|
Bot: Comandos disponibles: help, ping, status, info, version
|
|
|
|
Usuario: hola mundo
|
|
Bot: Comando desconocido: hola. Usa 'help' para ver los comandos disponibles.
|
|
```
|
|
|
|
## Decisiones de diseno
|
|
|
|
- **Solo para robots**: los agentes con LLM siguen necesitando `!` para distinguir comandos de mensajes naturales. Cambiar esto para agentes romperia el flujo de reglas → LLM.
|
|
- **Retrocompatibilidad con `!`**: aunque el prefijo este vacio, seguir aceptando `!` para no confundir a usuarios acostumbrados.
|
|
- **Comando desconocido explicito**: cuando todo es un potencial comando, responder "desconocido" con sugerencia de `help` es mejor UX que silencio.
|
|
- **Cambio en listener, no en robot**: el parseo debe ocurrir en la capa impura (listener), no en la logica de routing.
|
|
|
|
## Prerequisitos
|
|
|
|
- Issue 0030 completado (Robot vs Agent separacion) ✓
|
|
|
|
## Riesgos
|
|
|
|
- **Falsos positivos**: mensajes que no son comandos se interpretaran como comandos desconocidos. Mitigacion: esto es intencional para robots (solo reciben comandos).
|
|
- **Retrocompatibilidad**: agentes existentes con `command_prefix: "!"` no deben cambiar. Mitigacion: el cambio solo aplica cuando prefix es vacio.
|