phenotypic.sdk_.finalization_input_object

phenotypic.sdk_.finalization_input_object(output_dir: Path) → dict[str, object]

Return the versioned finalization-input object (spec §5.5).

The object, not its digest: a caller that needs the digest passes this to phenotypic.sdk_._digests.canonical_digest(), and a caller that needs to explain a mismatch – “the metadata snapshot changed” rather than “the digest changed” – reads the fields.

schema_version is what makes adding a fourth input a reader-side bump instead of a second tree migration.

Parameters:

output_dir (Path) – Run output root.

Returns:

{"schema_version", "metadata_sha256", "include_dataset_column", "no_qc"}. Every value comes from config via .get and is None when the run never recorded it – a shape with no state file at all still returns the four keys.

Return type:

dict[str, object]