Return the output node message as a named output entry

[pedroigorjs]

What

The message field of Output and MultipleOutputs nodes now shows up as a regular entry in the normalized outputs list, using message as its name.

Before:

"outputs": [
  { "name": "output", "value": "1", "message": "first" }
]

After:

"outputs": [
  { "name": "output", "value": "1", "message": "first" },
  { "name": "message", "value": "first", "message": "first" }
]

Why

Consumers of Execution.to_normalized_dict() read the outputs list as a flat collection of named values. The message was only reachable as an extra key inside each value entry, so anyone treating the list uniformly never saw it. Exposing it as its own named entry makes the message available through the same access pattern as every other output.

How

The change lives in normalize_execution_for_debug_iter in retrack/utils/transformers.py. For each terminal node we now count how many entries it contributed and append a single message entry right after them.

Rules applied:

1. A null message produces no entry at all.
2. A terminal node that produced no value, meaning it was not the path taken for that record, produces neither a value nor a message. This keeps the message scoped to the branch that actually ran, which matters for graphs with several Output nodes.
3. MultipleOutputs emits one message entry after all of its keys instead of repeating the message on every key.

Backwards compatibility

The inline message key stays on the value entries, so existing readers keep working. The new entry also carries a message key with the same content, which means every dict in outputs still has the same shape and code that reads entry["message"] across the whole list will not raise a KeyError.

Released as 3.8.0a0 so the new shape can be validated by a consumer before the final minor.

Testing

Five expectations in tests/test_transformers/test_normalize_debug.py were updated and two cases were added, one covering a filled message on a node without a value and one covering a graph where only the executed Output emits its message. The tests/resources/executions/multiple-ifs.json fixture was regenerated. Full suite passes with 139 tests.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	70	5	93%	48, 62–64, 152
executor.py	131	10	92%	62, 74–75, 153, 225, 271, 289, 293, 305, 313
request_manager.py	80	7	91%	16, 35, 54, 69–70, 149, 152
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	93	3	97%	123, 126, 171
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	44	2	95%	60, 63
flow.py	44	1	98%	18
flow_connector.py	25	12	52%	24–48
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	5	82%	17–18, 106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
transformers.py	168	16	90%	20, 40–41, 55, 60–61, 66, 69, 72, 75, 78, 112, 172, 181, 230, 386
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1694	106	94%

Tests	Skipped	Failures	Errors	Time
139	0 💤	0 ❌	0 🔥	4.858s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	70	5	93%	48, 62–64, 152
executor.py	131	10	92%	62, 74–75, 153, 225, 271, 289, 293, 305, 313
request_manager.py	80	7	91%	16, 35, 54, 69–70, 149, 152
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	93	3	97%	123, 126, 171
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	44	2	95%	60, 63
flow.py	44	1	98%	18
flow_connector.py	25	12	52%	24–48
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	3	89%	106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
transformers.py	168	16	90%	20, 40–41, 55, 60–61, 66, 69, 72, 75, 78, 112, 172, 181, 230, 386
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1694	104	94%

Tests	Skipped	Failures	Errors	Time
139	0 💤	0 ❌	0 🔥	3.829s ⏱️