.channels.json (referencia)

このコンテンツはまだ日本語訳がありません。

Qué cubre esta página

Formato de .channels.json en puruto-telegram
Cómo lo usa el bot (bot.py) y la DB (db.py)
Semántica de registro/eliminación de canales
Límites del scaffold MVP

Alcance

Fuente de verdad:

/Users/pepetox/Documents/01-code/puruto/.claude/skills/puruto-generator/templates/telegram/.channels.json.tpl
/Users/pepetox/Documents/01-code/puruto/.claude/skills/puruto-generator/templates/telegram/db.py.tpl
/Users/pepetox/Documents/01-code/puruto/.claude/skills/puruto-generator/templates/telegram/bot.py.tpl

Estructura raíz

El fichero debe ser un JSON objeto con una lista channels:

{
  "channels": []
}

Ejemplo

{
  "channels": [
    "puruto-financial",
    "puruto-health",
    "puruto-data"
  ]
}

Qué representa

channels[] es la lista de Purutos que el bot puede exponer como canales conversacionales.

Se usa para:

comandos dinámicos (/puruto-financial, /puruto-health, etc.)
teclado de selección de canal
validación de cambios de canal en mensajes

Relación con `db/telegram.db`

Hay dos piezas distintas:

.channels.json: catálogo de canales disponibles (config declarativa)
db/telegram.db: canal activo por usuario (active_channels)

No son equivalentes.

Cómo lo usa el scaffold

`db.py`

get_all_channels() lee .channels.json
register_channel(name) añade el nombre si no existe (sin duplicado exacto)
remove_channel(name) reescribe la lista sin ese canal

`bot.py`

Al arrancar:

carga channels = get_all_channels()
registra CommandHandler(channel, ...) para cada canal

Implicación importante:

si cambias .channels.json, debes reiniciar python3 bot.py para que el bot cargue los nuevos comandos

Reglas prácticas del contenido

elementos de channels[] deben ser strings
lo normal es usar nombres de repos del ecosistema (puruto-*)
el orden de la lista afecta al orden visual en /list y al teclado (tras el canal activo)

Ejemplo de flujo (scaffold)

Añades canal (register_channel o skill /add-channel)
.channels.json se actualiza
Reinicias el bot
El bot expone el nuevo comando /<canal>

Limitaciones del MVP

no hay validación JSON/schema estricta de .channels.json
get_all_channels() hace json.loads(...).get("channels", []) sin validación de tipos
si el archivo está corrupto, puede fallar al arrancar el bot

Errores comunes

El canal no aparece en Telegram

Revisa:

que el canal esté en .channels.json
que reiniciaste python3 bot.py
que el nombre coincide exactamente con el registrado

El bot arranca pero no enruta al Puruto esperado