Mondaic

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()

def explain(records: RecordStore, task: str) -> str: ...

Return the human-readable explanation for task’s latest key.

Parameters
  • records RecordStore — The record store to read manifests from.
  • task str — 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()

def explain_ref(records: RecordStore, ref: str, depth: int = 8) -> str: ...

Return an indented artifact provenance tree.

Parameters
  • records RecordStore — The record store to walk.
  • ref str — The content digest to explain.
  • depth int — Maximum number of levels to walk upward.
Returns str — A multi-line explanation, one indent level per hop.

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
  • manifests list[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.