Execute or verify an immutable artifact graph generation

A new generation can reference unchanged nodes in a completed prior generation without copying their files. A node is reused only when its complete resolved definition and producer lineage match. Changed inputs never overwrite a prior generation. Resume requires the same plan, inputs and runtime and rechecks accepted artifacts before dispatching any writer.

Usage

reflow_artifact_plan_run(plan, directory, previous = NULL)

reflow_artifact_plan_resume(plan, directory, reconciliations = list())

Arguments

plan

A reflow_artifact_plan().

directory

Fresh generation directory, or existing one for resume.

previous

Optional completed generation to verify for in-place reuse.

reconciliations

Named list keyed by failed stage identifiers. Each element has exactly reconciled_attempt and reconciliation, as in reflow_artifact_resume(). No process absence is inferred automatically.

Value

A graph descriptor containing authenticated node descriptors.

Details

Execution is serial and trusted, not sandboxed or resource supervised. Stale locks require external inspection; they are never stolen. Failed child attempts retain the explicit reconciliation contract of reflow_artifact_resume(). Atomic writes provide rename visibility, not power-loss durability. Keep prior generations available while referenced.