salvus.flow.acta.memo.explain
salvus.flow.acta.memo.explain salvus flow acta memo explain Cache-key differences and artifact provenance.
Explanations compare stored manifests. Cache hits do not create manifests.
Functions
explain()
explain()def explain(records: RecordStore, task: str) -> str: ...Return the human-readable explanation for task’s latest key.
Parameters
recordsRecordStore — The record store to read manifests from.taskstr — Task name to explain.
Returns str — A one-line message naming the first differing envelope member or spec field, or explaining why none was found.
explain_ref()
explain_ref()def explain_ref(records: RecordStore, ref: str, depth: int = 8) -> str: ...Return an indented artifact provenance tree.
Parameters
recordsRecordStore — The record store to walk.refstr — The content digest to explain.depthint =8— Maximum number of levels to walk upward.
Returns str — A multi-line explanation, one indent level per hop.
render_manifest_table()
render_manifest_table()def render_manifest_table(manifests: list[Manifest]) -> str: ...Render a plain-text table of manifests, most recent last.
Includes recorded computations only; cache hits do not create manifests.
Parameters
manifestslist[Manifest] — Manifests to render, in the order given.
Returns str — A table with columns: task, key prefix, total timing, host, created-at timestamp. Empty manifests render as a one-line notice.