materialize-final-publication

name	materialize-final-publication
description	Assemble one decision-maker final report from canonical reporting packets, decision memo, expert reports, and DB evidence basis.

Materialize Final Publication

Core Goal

• Assemble canonical reporting outputs into one decision-maker environmental policy report artifact.
• Preserve release posture, evidence index, uncertainty register, remaining disputes, recommendations, published sections, and upstream audit refs in one durable object.
• Keep publication semantics in a skill rather than pushing them into runtime.

Triggering Conditions

• A canonical council decision already exists for the round.
• Need one final report object rather than forcing downstream consumers to re-open each canonical report separately.
• Need explicit release vs withhold posture with audit completeness and decision-maker report sections.

Read/Write Contract

• Reads run_dir/reporting/reporting_handoff_<round_id>.json by default.
• Reads run_dir/reporting/council_decision_<round_id>.json by default.
• Reads run_dir/reporting/expert_report_social_investigator_<round_id>.json by default when present.
• Reads run_dir/reporting/expert_report_environmental_investigator_<round_id>.json by default when present.
• Reads run_dir/report_basis/frozen_report_basis_<round_id>.json by default.
• Reads run_dir/runtime/supervisor_state_<round_id>.json by default when present.
• Writes run_dir/reporting/final_publication_<round_id>.json by default.
• Requires explicit operator approval through the reporting skill approval path before governed publish/finalize execution.

Required Input

• run_dir
• run_id
• round_id
• Optional:
  • reporting_handoff_path
  • decision_path
  • social_investigator_report_path
  • environmental_investigator_report_path
  • report_basis_path
  • supervisor_state_path
  • output_path
  • allow_overwrite

Output Contract

• status
• summary
• receipt_id
• batch_id
• artifact_refs
• canonical_ids
• warnings
• deliberation_sync
• analysis_sync
• board_handoff
• The emitted final publication preserves normalized cross-plane trace metadata in board_state_source, coverage_source, reporting_handoff_source, decision_source, report_basis_source, supervisor_state_source, role-report sources, db_path, and observed_inputs.
• The emitted final publication includes decision_maker_report, evidence_index, uncertainty_register, residual_disputes, and policy_recommendations. It must not present heuristic helper cues as findings unless they are cited by DB reporting or council basis objects.

References

• ../../docs/openclaw-project-overview.md
• ../../docs/openclaw-skills-refactor-checklist-v2.md

Scripts

• scripts/materialize_final_publication.py