Files

T

egutierrez 2a3d780347 feat(doctor): add fn doctor CLI + 14 functions for system management

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>

2026-05-07 01:42:10 +02:00

2.0 KiB

Raw Blame History

/entrada_diario — Añadir entrada al diario del día

Wrapper sobre append_diary_entry_bash_infra. La función del registry maneja todo el manejo de archivos (crear docs/diary/YYYY-MM-DD.md si no existe, append seguro, formato exacto). Este comando solo decide el contenido.

Uso

/entrada_diario <descripción del bloque de trabajo>
/entrada_diario                            # sin args → resume sesión actual

Pasos del asistente

Componer TITULO (corto, una linea) y CUERPO (viñetas markdown):
- Con $ARGUMENTS: derivar TITULO directo del argumento; CUERPO con viñetas concretas (- Hecho:, - Pendiente:).
- Sin $ARGUMENTS: revisar TaskList + git log --since=today + git status y resumir en 3-5 viñetas.

Llamar la función del registry:

cd /home/lucas/fn_registry
source bash/functions/infra/append_diary_entry.sh
append_diary_entry "<TITULO>" "$(cat <<'EOF'
<CUERPO>
EOF
)"

La función imprime el path del archivo escrito.

Reglas de estilo

Viñetas breves, no párrafos. Verbos en pasado para lo hecho, infinitivo para pendientes.
Enlaces a artefactos: commits (SHA corto 7-8 chars), ADRs ([0001](../adr/0001-...)), funciones del registry por ID.
No duplicar con CHANGELOG: el diario es contexto operativo ("qué hice hoy"), el CHANGELOG es "qué cambió cara al usuario".
NUNCA editar secciones anteriores. La función solo append.

Relación con otras formas de registro

Si quieres documentar...	Usa
Qué trabajé hoy	`/entrada_diario` → `docs/diary/`
Qué cambió en el código (cara usuario/agentes)	Editar `CHANGELOG.md` directamente
Por qué tomamos una decisión arquitectural	Nuevo ADR en `docs/adr/NNNN-*.md`
Una regla operativa nueva del registry	Nuevo archivo en `.claude/rules/` + entrada en INDEX.md

Para tocar la lógica

Editar la función append_diary_entry_bash_infra en el registry, no este wrapper.

2.0 KiB Raw Blame History