chore: auto-commit (799 archivos)

- .claude/CLAUDE.md
- .claude/commands/subagentes.md
- .claude/rules/INDEX.md
- .mcp.json
- bash/functions/cybersecurity/analyze_dns.md
- bash/functions/cybersecurity/audit_http_headers.md
- bash/functions/cybersecurity/audit_ssh_config.md
- bash/functions/cybersecurity/check_firewall.md
- bash/functions/cybersecurity/detect_suspicious_users.md
- bash/functions/cybersecurity/encrypt_file.md
- ...

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

functions/core/all_slice.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func All[T any](slice []T, predicate func(T) bool) bool"
 description: "Devuelve true si todos los elementos del slice cumplen el predicado."
-tags: [slice, functional, generic, predicate]
+tags: [slice, functional, generic, predicate, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/any_slice.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Any[T any](slice []T, predicate func(T) bool) bool"
 description: "Devuelve true si al menos un elemento del slice cumple el predicado."
-tags: [slice, functional, generic, predicate]
+tags: [slice, functional, generic, predicate, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/assert_contains_all.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func AssertContainsAll(haystack, needles []string) (bool, []string)"
 description: "Verifica que el slice haystack contiene todos los elementos de needles. Retorna (true, nil) si todos estan presentes, o (false, missing) con los elementos faltantes."
-tags: [testing, assert, slice, contains, pure]
+tags: [testing, assert, slice, contains, pure, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/assert_json_equal.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func AssertJSONEqual(expected, actual []byte) (bool, string)"
 description: "Compara dos payloads JSON por igualdad semantica. Insensible al orden de claves. Retorna (true, \"\") si son equivalentes o (false, diff) con descripcion legible de la diferencia."
-tags: [testing, json, assert, diff, pure]
+tags: [testing, json, assert, diff, pure, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/chunk.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Chunk[T any](xs []T, size int) [][]T"
 description: "Divide un slice en trozos (sub-slices) de tamanio N. El ultimo trozo puede contener menos de N elementos. Retorna nil si el slice esta vacio. Entra en panic si size <= 0."
-tags: [slice, chunk, batch, generic]
+tags: [slice, chunk, batch, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/compare_versions.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func CompareVersions(a, b string) int"
 description: "Compara dos strings de version semantica (semver). Soporta formato con o sin prefijo 'v'. Retorna -1, 0 o 1."
-tags: [core, version, semver, compare, parse]
+tags: [core, version, semver, compare, parse, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/compose2.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Compose2[A, B, C any](f2 func(B) C, f1 func(A) B) func(A) C"
 description: "Compone dos funciones de derecha a izquierda. compose2(g, f)(x) = g(f(x))."
-tags: [functional, composition, generic]
+tags: [functional, composition, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/const_func.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Const[T, U any](value T) func(U) T"
 description: "Devuelve una funcion que siempre retorna el valor dado, ignorando su argumento."
-tags: [functional, generic, const]
+tags: [functional, generic, const, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/cron_match.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func CronMatch(sched CronSchedule, t time.Time) bool"
 description: "Verifica si un instante de tiempo coincide con un cron schedule. Compara los 5 campos (minuto, hora, dia del mes, mes, dia de la semana) y retorna true si todos coinciden."
-tags: [cron, scheduling, matching, time, pure]
+tags: [cron, scheduling, matching, time, pure, pendiente-usar]
 uses_functions: []
 uses_types: [cron_schedule_go_core]
 returns: []

functions/core/curry2.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Curry2[A, B, C any](f func(A, B) C) func(A) func(B) C"
 description: "Transforma una funcion de dos argumentos en forma currificada."
-tags: [functional, generic, curry]
+tags: [functional, generic, curry, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/detect_cycle.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func DetectCycle(conn *sql.DB, table, fromCol, toCol, filterCol, fromNode, toNode string) error"
 description: "Detecta ciclos en un grafo dirigido almacenado en SQLite usando BFS antes de insertar una arista."
-tags: [graph, cycle, bfs, sqlite, validation]
+tags: [graph, cycle, bfs, sqlite, validation, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/drop.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Drop[T any](slice []T, n int) []T"
 description: "Elimina los primeros n elementos de un slice y devuelve el resto."
-tags: [slice, functional, generic]
+tags: [slice, functional, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/filter_slice.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func FilterSlice[T any](xs []T, pred func(T) bool) []T"
 description: "Filtra un slice aplicando un predicado sin mutar el original. Retorna un nuevo slice con los elementos que cumplen la condicion."
-tags: [slice, functional, generic, filter]
+tags: [slice, functional, generic, filter, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/find_index.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func FindIndex[T any](slice []T, predicate func(T) bool) Option[int]"
 description: "Devuelve el indice del primer elemento que cumple el predicado, envuelto en Option."
-tags: [slice, functional, generic, search]
+tags: [slice, functional, generic, search, pendiente-usar]
 uses_functions: []
 uses_types: [option_go_core]
 returns: [option_go_core]

functions/core/flat_map_slice.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func FlatMapSlice[T, U any](slice []T, f func(T) []U) []U"
 description: "Aplica una funcion que devuelve slices a cada elemento y aplana el resultado."
-tags: [slice, functional, generic, flatmap]
+tags: [slice, functional, generic, flatmap, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/flatten.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Flatten[T any](slices [][]T) []T"
 description: "Aplana un slice de slices en un unico slice."
-tags: [slice, functional, generic]
+tags: [slice, functional, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/flip.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Flip[A, B, C any](f func(A, B) C) func(B, A) C"
 description: "Intercambia el orden de los argumentos de una funcion de dos parametros."
-tags: [functional, generic]
+tags: [functional, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/generate_id.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func GenerateID(name, lang, domain string) string"
 description: "Genera un ID canonico determinista a partir de nombre, lenguaje y dominio."
-tags: [id, naming, deterministic]
+tags: [id, naming, deterministic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/golden_diff.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func GoldenDiff(actual, golden []byte, threshold float64) (matched bool, similarity float64)"
 description: "Compara dos buffers byte-a-byte y retorna una puntuacion de similitud en [0,1]. similarity = matchedBytes / max(len(actual), len(golden)). matched = similarity >= (1.0 - threshold). threshold=0.0 exige match exacto; threshold=0.05 tolera hasta 5% de divergencia."
-tags: [diff, golden, testing, similarity, bytes, comparison]
+tags: [diff, golden, testing, similarity, bytes, comparison, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/group_by.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func GroupBy[T any, K comparable](slice []T, keyFn func(T) K) map[K][]T"
 description: "Agrupa elementos de un slice por clave generada con una funcion."
-tags: [slice, functional, generic, grouping]
+tags: [slice, functional, generic, grouping, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/html_to_markdown.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func HtmlToMarkdown(html string) string"
 description: "Convierte HTML a markdown legible. Parser recursivo del DOM via golang.org/x/net/html. MVP best-effort: soporta headings, parrafos, links, strong/em, code, pre, listas, blockquote, img, br, hr. Skippea script/style/noscript y sus descendientes. Texto plano con whitespace colapsado. Entidades HTML decodificadas."
-tags: [html, markdown, converter, parsing, text, core]
+tags: [html, markdown, converter, parsing, text, core, pendiente-usar]
 params:
   - name: html
     desc: "String HTML completo o fragmento a convertir. Puede incluir doctype, head y body, o ser solo un fragmento de markup."

functions/core/identity.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Identity[T any](x T) T"
 description: "Devuelve el valor recibido sin modificarlo. Elemento neutro de la composicion."
-tags: [functional, generic, identity]
+tags: [functional, generic, identity, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/join_by_key.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func JoinByKey(left, right []map[string]any, key, how string) []map[string]any"
 description: "Join de dos slices de map[string]any por una clave comun. Soporta inner, left, right y outer. Campos duplicados del right se sufijan con _right. Algoritmo O(n+m)."
-tags: [tabular, join, merge, go, core]
+tags: [tabular, join, merge, go, core, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/longest_common_prefix.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func LongestCommonPrefix(items []string) string"
 description: "Retorna el prefijo comun mas largo compartido por todos los strings del slice. Util para autocompletado de rutas y comandos."
-tags: [core, string, prefix, autocomplete, common]
+tags: [core, string, prefix, autocomplete, common, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/map_concurrent.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func MapConcurrent[T any, U any](xs []T, fn func(T) U, workers int) []U"
 description: "Aplica una funcion a cada elemento de un slice usando un pool de goroutines como workers. Los resultados preservan el orden original del slice de entrada."
-tags: [map, concurrent, parallel, generic]
+tags: [map, concurrent, parallel, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/map_slice.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func MapSlice[T any, U any](xs []T, fn func(T) U) []U"
 description: "Transforma cada elemento de un slice aplicando una funcion. Retorna un nuevo slice del mismo tamaño con los resultados."
-tags: [slice, functional, generic, map, transform]
+tags: [slice, functional, generic, map, transform, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/memoize.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Memoize[K comparable, V any](fn func(K) V) func(K) V"
 description: "Cachea resultados de una funcion pura. Retorna una nueva funcion que almacena en un mapa interno los resultados ya calculados, evitando recalculos para la misma clave."
-tags: [cache, memoize, functional, generic]
+tags: [cache, memoize, functional, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/parse_version.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func ParseVersion(content string) string"
 description: "Extrae el tag de version del primer campo de la primera linea de texto. Util para parsear archivos VERSION.txt o salida de comandos --version."
-tags: [core, version, parse, text, extract]
+tags: [core, version, parse, text, extract, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/partial2.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Partial2[A, B, C any](f func(A, B) C, a A) func(B) C"
 description: "Aplica parcialmente el primer argumento de una funcion de dos parametros."
-tags: [functional, generic, partial]
+tags: [functional, generic, partial, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/partition.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Partition[T any](xs []T, pred func(T) bool) ([]T, []T)"
 description: "Divide un slice en dos segun un predicado. El primer slice contiene los elementos que cumplen el predicado, el segundo los que no. Se preserva el orden original."
-tags: [slice, partition, functional, generic]
+tags: [slice, partition, functional, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/pipe2.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Pipe2[A, B, C any](f1 func(A) B, f2 func(B) C) func(A) C"
 description: "Compone dos funciones de izquierda a derecha. pipe2(f, g)(x) = g(f(x))."
-tags: [functional, composition, generic, pipe]
+tags: [functional, composition, generic, pipe, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/pipe3.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Pipe3[A, B, C, D any](f1 func(A) B, f2 func(B) C, f3 func(C) D) func(A) D"
 description: "Compone tres funciones de izquierda a derecha."
-tags: [functional, composition, generic, pipe]
+tags: [functional, composition, generic, pipe, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/pipeline.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Pipeline[T any](fns ...func(T) T) func(T) T"
 description: "Compone funciones T -> T en secuencia de izquierda a derecha. Pipeline(f, g, h)(x) equivale a h(g(f(x))). Sin funciones retorna la identidad."
-tags: [pipeline, compose, functional, generic]
+tags: [pipeline, compose, functional, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/reduce.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Reduce[T, U any](slice []T, initial U, f func(U, T) U) U"
 description: "Reduce un slice a un unico valor aplicando una funcion acumuladora de izquierda a derecha."
-tags: [slice, functional, generic, fold]
+tags: [slice, functional, generic, fold, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/rel_or_full.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func RelOrFull(base, target string) string"
 description: "Retorna el path de target relativo a base. Si filepath.Rel falla, retorna target sin cambios. Util para mostrar paths cortos en UIs."
-tags: [core, path, relative, filepath, display]
+tags: [core, path, relative, filepath, display, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/rewrite_rule.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func RewriteRule(rule, jsonColumn string) string"
 description: "Reescribe campos bare en una expresion SQL a llamadas json_extract sobre una columna JSON de SQLite."
-tags: [sql, json, sqlite, rewrite, assertion]
+tags: [sql, json, sqlite, rewrite, assertion, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/split_command_and_arg.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func SplitCommandAndArg(input string) (cmd, arg string, ok bool)"
 description: "Separa un string 'comando argumento' en sus dos partes por el primer espacio. Retorna ok=false si no hay espacio o el input esta vacio."
-tags: [core, string, split, command, parse, cli]
+tags: [core, string, split, command, parse, cli, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/take.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Take[T any](slice []T, n int) []T"
 description: "Devuelve los primeros n elementos de un slice."
-tags: [slice, functional, generic]
+tags: [slice, functional, generic, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/test_capture_logs.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func TestCaptureLogs(t *testing.T) (*bytes.Buffer, func() []string)"
 description: "Redirige log.SetOutput a un buffer para capturar logs durante un test. Retorna el buffer y una funcion que restaura el writer original y devuelve las lineas capturadas como slice. Registra t.Cleanup automaticamente."
-tags: [testing, logging, capture, test_helper, log]
+tags: [testing, logging, capture, test_helper, log, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/test_db_seed.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func TestDBSeed(t *testing.T, db *sql.DB, table string, rows []map[string]any) error"
 description: "Inserta filas en una tabla de forma dinamica usando una transaccion. Las columnas se infieren del primer mapa en orden alfabetico. Retorna error si la transaccion falla."
-tags: [testing, database, sqlite, seed, fixtures, test_helper]
+tags: [testing, database, sqlite, seed, fixtures, test_helper, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/test_db_setup.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func TestDBSetup(t *testing.T, schema string) TestDB"
 description: "Abre una base de datos SQLite en memoria (:memory:), ejecuta el schema SQL proporcionado y registra t.Cleanup. Retorna TestDB listo para usar en tests."
-tags: [testing, database, sqlite, schema, test_helper]
+tags: [testing, database, sqlite, schema, test_helper, pendiente-usar]
 uses_functions: []
 uses_types: [test_db_go_core]
 returns: [test_db_go_core]

functions/core/test_env_set.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func TestEnvSet(t *testing.T, vars map[string]string) func()"
 description: "Setea variables de entorno para la duracion del test y retorna una funcion restore. Las variables inexistentes se eliminan al restaurar. Registra t.Cleanup automaticamente."
-tags: [testing, env, environment, test_helper]
+tags: [testing, env, environment, test_helper, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/test_fixture_load.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func TestFixtureLoad(t *testing.T, path string, dst any) error"
 description: "Carga un archivo de fixture desde disco y lo deserializa en dst. Soporta JSON (stdlib). YAML es stub — retorna error informativo. Retorna error si el archivo no existe o el parsing falla."
-tags: [testing, fixtures, json, yaml, test_helper, io]
+tags: [testing, fixtures, json, yaml, test_helper, io, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/test_http_server.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: impure
 signature: "func TestHTTPServer(t *testing.T, routes map[string]http.HandlerFunc) TestServer"
 description: "Crea un httptest.Server con un ServeMux configurado desde un mapa de rutas. Registra t.Cleanup automaticamente. Retorna TestServer con URL, cliente y funcion de cierre."
-tags: [testing, http, server, httptest, test_helper]
+tags: [testing, http, server, httptest, test_helper, pendiente-usar]
 uses_functions: []
 uses_types: [test_server_go_core]
 returns: [test_server_go_core]

functions/core/uncurry2.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Uncurry2[A, B, C any](f func(A) func(B) C) func(A, B) C"
 description: "Transforma una funcion currificada en una funcion normal de dos argumentos."
-tags: [functional, generic, curry]
+tags: [functional, generic, curry, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/unique.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Unique[T comparable](slice []T) []T"
 description: "Devuelve un slice con elementos unicos preservando el orden original."
-tags: [slice, functional, generic, dedup]
+tags: [slice, functional, generic, dedup, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/validate_struct_fields.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func ValidateStructFields(data map[string]any, rules map[string]string) (bool, []string)"
 description: "Valida campos de un map[string]any contra reglas declarativas tipo 'required,min=1,max=100,type=string'. Soporta required, type, min/max, minlen/maxlen, oneof, pattern. Pensado para validar metadata de entities en operations.db o resultados de queries sin definir structs Go. Acumula todos los errores."
-tags: [validation, map, rules, pure, core, operations]
+tags: [validation, map, rules, pure, core, operations, pendiente-usar]
 uses_functions: []
 uses_types: []
 returns: []

functions/core/zip.md

@@ -7,7 +7,7 @@ version: "1.0.0"
 purity: pure
 signature: "func Zip[T, U any](a []T, b []U) []Pair[T, U]"
 description: "Combina dos slices en un slice de pares elemento a elemento."
-tags: [slice, functional, generic, pair]
+tags: [slice, functional, generic, pair, pendiente-usar]
 uses_functions: []
 uses_types: [pair_go_core]
 returns: [pair_go_core]