Module okf 

OKF bundle export (decided.output.okf + the recency join) — decided export --okf, per PORT-CONTRACT.d/17 §4.

A derived tree of Markdown files: one per typed artifact at its path relative to the exported corpus root, plus generated index.md and log.md. OKF v0.2 generated.at derives from the last git commit time with the committer’s stored offset preserved (%cI, ADR-045); when git cannot answer, generated is omitted and log.md degrades to a placeholder.

Structs

ArtifactRecency

One artifact’s git-derived authored times as verbatim-offset ISO strings (already fromisoformat().isoformat() round-tripped), or None when git does not know. Mirrors ArtifactRecency with with_creation=True.

Functions

artifact_recency

artifact_recency(directory, with_creation=True), restricted to the export’s artifact set (identical to the oracle’s recognised-walk set). Outside a repository every value is None — no error crosses the boundary (ADR-045).

render_okf_bundle

render_okf_bundle(export, recency, root) — {relative path: contents} in a sorted map (the CLI writes sorted(bundle.items())).