Function _copy_submodules_for_workflow

src/harness/utils/reproducibility.py:246–278

Copy all submodule YAMLs referenced (recursively) by the workflow. Submodules are copied under a `submodules/` directory inside the reproducibility snapshot. Paths are preserved relative to the project root when possible, falling back to basenames otherwise.

(
    plan_path: Path, project_root: Path, repro_dir: Path
)

def _copy_submodules_for_workflow(
    plan_path: Path, project_root: Path, repro_dir: Path
) -> None:
    """Copy all submodule YAMLs referenced (recursively) by the workflow.

    Submodules are copied under a `submodules/` directory inside the
    reproducibility snapshot. Paths are preserved relative to the project root
    when possible, falling back to basenames otherwise.
    """
    # Discover submodules/modules by parsing YAML relationships. This works
    # uniformly for both CLI and YAML Flow Editor runs, since the latter
    # produces a self-contained run_<id>.yaml that references its modules.
    try:
        submodule_paths = _collect_submodule_paths(plan_path)
    except Exception:
        # Best-effort only: do not fail reproducibility snapshot if this fails
        return

    if not submodule_paths:
        return

    # For simplicity and portability, store all discovered module/submodule YAMLs
    # under a flat `modules/` directory, preserving only the filename. This
    # matches the expected layout used for reproducibility.
    modules_root = repro_dir / "modules"
    for sub_path in sorted(submodule_paths):
        try:
            dest = modules_root / sub_path.name
            dest.parent.mkdir(parents=True, exist_ok=True)
            _copy_file_if_exists(sub_path, dest)
        except Exception:
            # Ignore individual copy errors to keep snapshot best-effort
            continue


def ensure_workflow_submodules_snapshot(