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>
48 lines
2.0 KiB
Markdown
48 lines
2.0 KiB
Markdown
# /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
|
|
|
|
1. **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.
|
|
|
|
2. **Llamar la función del registry**:
|
|
```bash
|
|
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.
|