$commit
$commit : string
What removing one commit would actually free.
The freed and retained lists are both reported because the retained one is the answer an operator did not expect. A commit that wrote four megabytes usually frees far less than that: its frames are shared with the commits around it, held as delta anchors by later versions of the same subject, or named as dictionaries by frames elsewhere in the store.
complete is false when the reachability walk could not finish, and then nothing here can be acted
on. A partial walk cannot prove a frame is unreferenced, only that it did not happen to see a
reference, and those are different claims.
__construct(string $commit, list$freed = [], array $retained = [], int $bytes = 0, bool $complete = true) : mixed
Constructs a removal cost.
| string | $commit | The commit that was priced. |
| list |
$freed | Frame addresses nothing else would need. |
| array |
$retained | Frame address keyed to why it would still be needed. |
| int | $bytes | Stored bytes the freed frames occupy. |
| bool | $complete | Whether the reachability walk finished, and so whether any of this can be acted on. |