chore: auto-commit (286 archivos)

- .claude/agents/fn-orquestador/SKILL.md
- .claude/commands/fn_claude.md
- .claude/rules/INDEX.md
- .claude/rules/cpp_apps.md
- .claude/rules/ids_naming.md
- CHANGELOG.md
- apps/dag_engine/README.md
- apps/dag_engine/api.go
- apps/dag_engine/dags_migrated/example.yaml
- apps/dag_engine/dags_migrated/example_lineage_tracking.yaml
- ...

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

apps/dag_engine/README.md

@@ -155,9 +155,10 @@ handler_on:
 | `name` | string | (obligatorio) | Identificador del step dentro del DAG. |
 | `id` | string | "" | Override del id auto-generado. |
 | `description` | string | "" | Texto libre. |
-| `command` | string | "" | Comando shell (mutuamente excluyente con `script`). |
+| `command` | string | "" | Comando shell (mutuamente excluyente con `script`/`function`). |
 | `script` | string | "" | Bloque heredoc. Util para Python/Lua inline. |
-| `args` | list[string] | [] | Args extra para `command`. |
+| `function` | string | "" | ID de funcion del registry (ej `audit_capability_groups_go_infra`). Si set, executor invoca `${FN_REGISTRY_ROOT}/fn run <id> <args...>` y captura `function_id` en `dag_step_results`. Mutuamente exclusivo con `command`/`script`; si convive, gana `function`. |
+| `args` | list[string] | [] | Args extra para `command` o para la `function`. |
 | `shell` | string | hereda | Override del shell. |
 | `dir` / `working_dir` | string | hereda | Working dir para este step. |
 | `depends` | list[string] | [] | Steps que deben terminar OK antes. Si vacio + `type:graph`, arranca en paralelo. |
@@ -170,6 +171,28 @@ handler_on:
 | `output` | string | "" | Nombre de variable donde guardar stdout (consumible por dependientes). |
 | `tags` | list[string] | [] | Tags por step (UI). |
 
+### Function steps (coherencia con el registry)
+
+Un DAG idiomatico llama funciones del registry, no scripts ad-hoc. Cada step `function:` queda trazado en `call_monitor.calls` por el hook PostToolUse del agente y en `dag_step_results.function_id` del propio dag_engine — el bucle reactivo (issue 0085) tiene visibilidad end-to-end.
+
+```yaml
+steps:
+  - name: audit_capabilities
+    function: audit_capability_groups_go_infra
+    args: ["--json"]
+    description: "Audita drift entre tags de capability group y paginas madre"
+```
+
+Ventajas vs `command: ./fn run ...`:
+
+- `function_id` se persiste como columna dedicada en `dag_step_results` (filtrable, agrupable).
+- El frontend `dag_engine_ui` muestra badge + panel lateral con `uses_functions` (subfunciones que el step va a usar transitivamente).
+- API: `GET /api/functions/{id}` devuelve `{id, name, description, signature, purity, domain, lang, uses_functions[], uses_types[]}` leyendo `registry.db` read-only. La UI consume este endpoint al expandir un step.
+- Validator regex en `dag_validate`: `^[a-z0-9_]+_[a-z]+_[a-z]+$`. ID invalido = error.
+- Variables de entorno: `FN_REGISTRY_ROOT` (default `/home/lucas/fn_registry`) localiza el binario `fn`. Override con `FN_BIN=/path/al/fn`.
+
+Ejemplo completo: `~/.dagu/dags/example-fn-call.yaml`.
+
 ### Cron schedule
 
 5 campos clasicos: `min hour dom mon dow`. Ejemplos: