Publication Metadata API

这些 API 用于 workspace publication metadata、staging branch 命名和恢复判断，主要面向运行时维护。

WorkspacePublicationPlan(logical_task_key, ...)	Capture the metadata and fence decisions for one workspace publish.
logical_task_key(task)	Build the stable publish-fence identity for a Conductor task attempt.
metadata_value(value)	Serialize a LakeFS metadata value into the string form LakeFS stores.
perago_metadata(*, task, workspace, ...[, extra])	Build the Perago metadata map for one workspace transaction phase.
confirm_metadata_extra(*, staging_branch, ...)	Build extra metadata written during the confirm/publish phase.
choose_publish_base(*, workspace, ...)	Choose the publish base that the current attempt is allowed to merge on.
build_workspace_publication_plan(*, task, ...)	Assemble the full publication plan for a workspace task attempt.
find_matching_publication_commit(commits, *, ...)	Find the published commit that matches one staged workspace attempt.
staging_branch_name(task)	Build the internal LakeFS staging branch name for one attempt.