fn_registry/bash/functions/infra/append_diary_entry.md

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 pendiente-usar				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	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.