Function final_state 

pub fn final_state(f: &FileChange) -> Result<Staged<'_>, EngineError>

The core tree builder’s rule: the file’s final state, every hunk applied.