egutierrez
625569485f
Adds `fn doctor` read-only diagnostic command with subcommands artefacts, services, sync, uses-functions, unused, and --json flag for agents. Each subcommand wraps a registry function in functions/infra/. New functions: - artefact_doctor, services_status, pc_locations_drift, audit_uses_functions, find_unused_functions (Go diagnostics) - backup_sqlite_db, rotate_backups, wait_for_http, wait_for_port, port_kill, tail_journal, pre_commit_hook_install (bash utilities) - notify_telegram (Go HTTP) - backup_all pipeline (tag launcher) Plus prior session leftovers (scan_secrets_in_dirty, append_diary_entry, git utilities, http_session_cookie_middleware, compile/full-git pipelines). Fixes pc_locations_drift filepath.Join bug with absolute dir_path. Documents fn doctor in CLAUDE.md, .claude/rules/fn_doctor.md (rule 23), docs/architecture.md, CHANGELOG.md (2026-05-07), and diary entry. First fn doctor uses-functions run found drift in 7/12 apps (deuda para sincronizar app.md con imports reales). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
---
|
|
name: notify_telegram
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func NotifyTelegram(botToken string, chatID string, text string, parseMode string) error"
|
|
description: "Envía un mensaje a un chat de Telegram via Bot API. Útil para alertas de deploy, fallos de assertions y eventos del bucle reactivo."
|
|
tags: [notify, telegram, alert, http]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: ["bytes", "encoding/json", "fmt", "io", "net/http", "time"]
|
|
params:
|
|
- name: botToken
|
|
desc: "Token del bot Telegram (formato 123456:ABC-DEF...). Sin prefijo 'bot'."
|
|
- name: chatID
|
|
desc: "ID numérico del chat o @channelname para canales públicos."
|
|
- name: text
|
|
desc: "Cuerpo del mensaje. Máximo 4096 chars según límite de Telegram. Si excede, se trunca a 4093 + '...'."
|
|
- name: parseMode
|
|
desc: "Modo de formato del texto. Valores válidos: '' (plain), 'Markdown', 'MarkdownV2', 'HTML'. Cualquier otro valor devuelve error."
|
|
output: "error nil si el mensaje se envió correctamente. Error con status code y body si la API responde con status != 200. Error con description si ok=false en la respuesta JSON."
|
|
tested: true
|
|
tests:
|
|
- "texto largo se trunca a 4096 chars con sufijo ..."
|
|
- "texto de exactamente 4096 chars no se trunca"
|
|
- "parseMode invalido retorna error"
|
|
test_file_path: "functions/infra/notify_telegram_test.go"
|
|
file_path: "functions/infra/notify_telegram.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
err := NotifyTelegram("123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11", "-1001234567890", "Deploy completado ✓", "")
|
|
if err != nil {
|
|
log.Printf("telegram notify failed: %v", err)
|
|
}
|
|
|
|
// Con Markdown
|
|
err = NotifyTelegram(token, chatID, "*ERROR*: assertion failed en `metabase_entities`", "Markdown")
|
|
```
|
|
|
|
## Notas
|
|
|
|
Sin retries. Caller hace backoff si necesario. Timeout fijo de 10 segundos. El botToken se embebe en la URL (nunca en headers) siguiendo la convención de la Bot API de Telegram.
|