fn_registry/functions/core/dag_parse.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
dag_parse	function	go	core	1.1.0	pure	func DagParse(data []byte) (DagDefinition, error)	Parsea YAML de definicion de DAG en formato compatible con Dagu. Soporta schedule como string o lista, env como lista de maps single-key (formato Dagu), handler_on y handlers como aliases, steps con command/script/depends/continue_on (failure, skipped y exit_code) y retry_policy (limit, interval_sec), y type graph.	dag yaml parsing workflow dagu pure scheduler		dag_definition_go_core dag_step_go_core dag_handlers_go_core		false		fmt strings gopkg.in/yaml.v3	name desc data contenido YAML de un archivo de definicion de DAG en formato Dagu	DagDefinition con todos los campos normalizados; error si el YAML es sintaticamente invalido	true	parsea DAG simple con steps y depends parsea schedule como string y como lista parsea env en formato lista de maps parsea handler_on y handlers como alias parsea continue_on y working_dir a nivel step parsea continue_on.exit_code y retry_policy parsea type graph	functions/core/dag_parse_test.go	functions/core/dag_parse.go

Ejemplo

data := []byte(`
name: mi-dag
schedule: "0 9 * * *"
steps:
  - name: hello
    command: echo "hello"
  - name: world
    command: echo "world"
    depends: [hello]
`)
dag, err := DagParse(data)
// dag.Name = "mi-dag"
// dag.Schedule = ["0 9 * * *"]
// dag.Steps[1].Depends = ["hello"]

Step con tolerancia de fallos y reintentos:

data := []byte(`
name: backup
steps:
  - name: snapshot
    command: ./backup.sh
    continue_on:
      exit_code: [4]      # exit 4 = "ok con avisos", no rompe el DAG
    retry_policy:
      limit: 3            # hasta 3 reintentos
      interval_sec: 10    # 10s entre intentos
`)
dag, _ := DagParse(data)
// dag.Steps[0].ContinueOn.ExitCodes = [4]
// dag.Steps[0].RetryPolicy.Limit = 3

Notas

Funcion pura (el YAML es inmutable, no hay I/O). Internamente usa un struct rawDag para deserializar loosely y luego normaliza campos polimorficos. La estrategia de normalizacion: schedule string->[]string, env lista->map, handlers single-o-lista->[]DagStep. handler_on tiene precedencia sobre handlers si ambos estan presentes.

continue_on y retry_policy son declarativos: DagParse solo los normaliza al modelo DagDefinition. Quien los interpreta (reintentar, tolerar exit codes) es el executor que consuma el DAG — en este ecosistema, apps/dag_engine.

Capability growth log

• v1.1.0 (2026-06-03) — minor: parsea continue_on.exit_code (lista de codigos de salida tolerados) y expone retry_policy ya existente en el modelo. Habilita reintentos y tolerancia de fallos reales en el executor de dag_engine.