fn_registry/bash/functions/infra/append_diary_entry.md at c6efbc977bb669e4826c16ba0e5efb13604fd323

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.4 KiB

Raw Blame History

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name

kind

lang

domain

version

purity

signature

description

tags

uses_functions

uses_types

returns

returns_optional

error_type

imports

params

output

tested

tests

test_file_path

file_path

append_diary_entry

function

bash

infra

1.0.0

impure

append_diary_entry(titulo: string, cuerpo: string) -> string

Añade una entrada al diario del dia en ${DIARY_DIR:-docs/diary}/YYYY-MM-DD.md. Crea el archivo con cabecera si no existe. Nunca reescribe contenido previo. Si cuerpo es vacio escribe solo el header de la seccion.

diary

markdown

append

idempotent

infra

false

error_go_core

name	desc
titulo	Titulo corto de la entrada (obligatorio). Se usa como cabecera H2 junto a la hora actual. Exit 2 si viene vacio.

name	desc
cuerpo	Cuerpo markdown de la entrada (opcional). Si se omite o es vacio, se escribe solo la linea de cabecera H2 sin parrafo adicional — util para marcar un momento sin detalle.

Path relativo al archivo de diario escrito (ej: docs/diary/2026-05-07.md). Varia segun DIARY_DIR y la fecha del sistema.

true

crear archivo nuevo con titulo y cuerpo

append mismo dia conserva primera entrada

entrada sin cuerpo escribe header

bash/functions/infra/append_diary_entry.sh

Ejemplo

source bash/functions/infra/append_diary_entry.sh

# Entrada con titulo y cuerpo
path=$(append_diary_entry "cerrado issue #42" "- Fix en http_client.cpp\n- Tests pasando")
echo "Escrito en: $path"

# Entrada sin cuerpo (marcar momento)
append_diary_entry "inicio sesion tarde"

# Usar directorio personalizado
DIARY_DIR=/home/lucas/personal/diary append_diary_entry "nota personal" "Reunion a las 18h."

Formato del bloque escrito

# 2026-05-07

## 14:32 — cerrado issue #42

- Fix en http_client.cpp
- Tests pasando

## 17:05 — inicio sesion tarde

Notas

Respeta la variable de entorno DIARY_DIR para reusar fuera del registry.
mkdir -p garantiza que el directorio se crea si no existe.
El bloque siempre empieza con una linea en blanco para separar entradas anteriores.
Los tests viven en el mismo .sh bajo el guard [ "$1" = "--test" ]. Ejecutar con bash bash/functions/infra/append_diary_entry.sh --test.
error_type: error_go_core sigue la convencion del registry para funciones bash impuras aunque bash use exit codes nativos, no el tipo Go.

2.4 KiB Raw Blame History

Ejemplo

Formato del bloque escrito

Notas

2.4 KiB

Raw Blame History