docs(flows): DoD obligatorio con user-facing surface + abrir issues 0100-0103 (taxonomia, frontmatter migration, dev_console, work dashboard)

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

apps/dag_engine/executor.go

@@ -160,15 +160,16 @@ func (e *Executor) executeStep(ctx context.Context, runID string, dag core.DagDe
 	// Resolve command source: function (registry) takes precedence over command/script.
 	var command string
 	var stepFunctionID string
+	var fnRegistryRoot string
 	if step.Function != "" {
 		stepFunctionID = step.Function
+		fnRegistryRoot = os.Getenv("FN_REGISTRY_ROOT")
+		if fnRegistryRoot == "" {
+			fnRegistryRoot = "/home/lucas/fn_registry"
+		}
 		fnBin := os.Getenv("FN_BIN")
 		if fnBin == "" {
-			root := os.Getenv("FN_REGISTRY_ROOT")
-			if root == "" {
-				root = "/home/lucas/fn_registry"
-			}
-			fnBin = root + "/fn"
+			fnBin = fnRegistryRoot + "/fn"
 		}
 		parts := []string{fnBin, "run", step.Function}
 		parts = append(parts, step.Args...)
@@ -191,6 +192,13 @@ func (e *Executor) executeStep(ctx context.Context, runID string, dag core.DagDe
 	// Build environment.
 	env := buildStepEnv(dag, step, daguEnvPath, outputs)
 
+	// For function: steps, force FN_REGISTRY_ROOT into env so `fn run`
+	// resolves the canonical registry.db (not whatever lives at the spawn cwd).
+	// Prevents the apps/dag_engine/registry.db stale-shadow bug (2026-05-16).
+	if stepFunctionID != "" {
+		env = append(env, "FN_REGISTRY_ROOT="+fnRegistryRoot)
+	}
+
 	if command == "" {
 		e.store.UpdateStepResult(stepID, "skipped", 0, "", "", nil, 0, "no command or script")
 		return nil
@@ -201,11 +209,15 @@ func (e *Executor) executeStep(ctx context.Context, runID string, dag core.DagDe
 	command = resolveStepRefs(command, outputs)
 	mu.Unlock()
 
-	// Determine working directory.
+	// Determine working directory. function: steps default to FN_REGISTRY_ROOT
+	// so `fn` resolves registry.db correctly via go.mod walk-up.
 	dir := step.Dir
 	if dir == "" {
 		dir = dag.WorkingDir
 	}
+	if dir == "" && stepFunctionID != "" {
+		dir = fnRegistryRoot
+	}
 
 	shell := step.Shell
 	if shell == "" {