"""Add portable documentation/font/source provenance without changing labels.

Run after geometry verification and before ZIP publication. Every existing
export hash is checked first, and the parent manifest is retained verbatim.
"""
from __future__ import annotations

import argparse
from importlib.metadata import version
import json
from pathlib import Path
import shutil

from fontTools import subset
from fontTools.ttLib import TTFont
from markdown_it import MarkdownIt

from pallet.cluster_targets import PROJECT, digest, save_json, timestamp
from pallet.fork_face_masks import copy_protected, safe_path, source_code_hashes
from pallet.fork_face_report import STYLE


def main(argv=None):
    parser=argparse.ArgumentParser(description=__doc__)
    parser.add_argument('--output',default='outputs/pallet_fork_face_masks_v1')
    parser.add_argument('--font',default='outputs/fork_face_browser_tooling/NotoSansCJKsc-Regular.otf')
    parser.add_argument('--font-license',default='outputs/fork_face_browser_tooling/FONT_LICENSE.txt')
    args=parser.parse_args(argv)
    out=Path(args.output).resolve();delivery=out/'delivery';manifest_path=delivery/'export_manifest.json'
    manifest=json.loads(manifest_path.read_text())
    validation=json.loads((out/'validation.json').read_text())
    run=json.loads((out/'run_manifest.json').read_text())
    if validation['state']!='passed' or validation['task_hash']!=manifest['task_hash']:
        raise ValueError('Full geometric verification required')
    if source_code_hashes()!=run['binding']['source_code']:
        raise ValueError('Frozen processing source changed')
    for relative,sha in manifest['files'].items():
        if digest(safe_path(delivery,relative))!=sha:
            raise ValueError(f'Existing asset changed; refusing finalization: {relative}')
    marker=delivery/'presentation_manifest.json'
    if marker.exists():
        old=json.loads(marker.read_text())
        if old['finalizer_sha256']!=digest(__file__):raise ValueError('Finalizer changed')
        print(json.dumps({'state':'already_finalized','output':str(delivery)}));return
    copy_protected(manifest_path,delivery/'provenance/initial_export_manifest.json')
    summary=manifest['summary'];pilot=json.loads((out/'pilot_summary_0.json').read_text())
    note=f'''## 提取质量与复核说明

{summary['selected_faces']:,}个结果是**几何面片候选**，不能解释为真实叉取面的数量。
同一个实际面可能被噪声、非平面结构或保守阈值分成多个片段；需要人工合并或删除。
逐托盘联合掩膜已经将本托盘选中的面片取并集，保持原有孔洞。

全部{summary['targets']:,}个托盘目标都列入复核清单，包括
{summary['target_status'].get('unresolved_no_mask',0)}个没有可用掩膜的目标。
点云读取和映射成功不等于叉取面身份已确认；未解决目标仍保留其人工托盘框。

训练试跑覆盖256帧、285个目标，只包含有正例训练帧的三种网格。
240×96和176×132没有正例训练帧，已在配置冻结后补做源数据对应检查，并在全量阶段处理；
这些检查没有用于模型、阈值或结构选择，也没有进行最终测试评分。

默认容差±25%下的570次比较，平均联合掩膜IoU为
{pilot['pilot_parameter_sensitivity']['mean_mask_iou']:.4f}，
其中{pilot['pilot_parameter_sensitivity']['below_0_85']}次低于0.85。
该指标显示**参数敏感性较高**，不能作为掩膜正确率或标注收敛的依据。
请优先复核叉孔背景、薄横梁、堆叠边界、顶面/地面混入以及重叠框冲突。

显示字体和文档完善未改变PNG掩膜、点云、COCO或目标/面记录；原始几何源码快照保持冻结。
'''
    (delivery/'quality_review_zh.md').write_text('# 叉取面候选质量说明\n\n'+note)
    report=delivery/'report_zh.md';report.write_text(report.read_text()+'\n'+note)
    font_dir=delivery/'assets';font_dir.mkdir(exist_ok=True)
    font=TTFont(args.font)
    options=subset.Options();options.flavor='woff';options.name_IDs=['*'];options.name_legacy=True
    sub=subset.Subsetter(options=options)
    text=report.read_text()+(delivery/'gallery.html').read_text()+''.join(chr(i) for i in range(32,127))
    sub.populate(text=text);sub.subset(font);font.flavor='woff';font.save(font_dir/'PalletForkFacesSans.woff')
    copy_protected(args.font_license,font_dir/'FONT_LICENSE.txt')
    custom='''<style>@font-face{font-family:PalletForkFaces;src:url('assets/PalletForkFacesSans.woff') format('woff');font-display:swap}body,button,input,select{font-family:PalletForkFaces,system-ui,sans-serif}pre,code{font-family:ui-monospace,PalletForkFaces,monospace}h1,h2{overflow-wrap:anywhere}.viewer>section{min-width:0}@media(max-width:750px){main{padding:16px}table{table-layout:fixed;font-size:12px}td,th{padding:6px;overflow-wrap:anywhere}}</style>'''
    rendered=MarkdownIt('commonmark').enable('table').render(report.read_text())
    (delivery/'report_zh.html').write_text('<!doctype html><html lang="zh-CN"><meta charset="utf-8"><title>叉取面提取报告</title>'+STYLE+custom+'<body><main>'+rendered+'</main></body></html>')
    gallery=delivery/'gallery.html';gallery.write_text(gallery.read_text().replace('<body>',custom+'<body>',1))
    for name in ('supplementary_grid_alignment.json',):
        copy_protected(out/name,delivery/'provenance'/name)
    # Capture the actual import closure for the standalone geometry entrypoint.
    code=['__init__.py','fork_face_masks.py','fork_geometry.py','fork_face_report.py','cluster_targets.py',
          'data/__init__.py','data/pcd.py','data/orientation.py','data/loader.py','data/manifest.py','data/dedup.py']
    for relative in code:copy_protected(PROJECT/'pallet'/relative,delivery/'source/pallet'/relative)
    copy_protected(PROJECT/'configs/fork_face_masks_v1.json',delivery/'source/configs/fork_face_masks_v1.json')
    copy_protected(PROJECT/'tests/test_fork_face_masks.py',delivery/'source/tests/test_fork_face_masks.py')
    copy_protected(PROJECT/'docs/pallet_fork_face_masks.md',delivery/'source/docs/pallet_fork_face_masks.md')
    copy_protected(__file__,delivery/'source/scripts/finalize_fork_face_delivery.py')
    save_json(delivery/'source/environment.json',{k:version(k) for k in ('numpy','scipy','opencv-python-headless','pycocotools','markdown-it-py','fonttools')})
    save_json(marker,{'state':'complete','created_at':timestamp(),'task_hash':manifest['task_hash'],
                      'finalizer_sha256':digest(__file__),'parent_export_manifest_sha256':digest(delivery/'provenance/initial_export_manifest.json'),
                      'labels_and_point_clouds_modified':False,'preview_coordinates_modified':False,
                      'font_source':'https://github.com/notofonts/noto-cjk','font_source_sha256':digest(args.font),
                      'source_snapshot_scope':'actual geometry import closure; raw PCD and full formal input dataset required to reextract'})
    manifest['presentation_manifest']='presentation_manifest.json'
    manifest['files']={str(p.relative_to(delivery)):digest(p) for p in sorted(delivery.rglob('*')) if p.is_file() and p!=manifest_path}
    save_json(manifest_path,manifest)
    print(json.dumps({'state':'finalized','files':len(manifest['files']),'geometry_unchanged':True},ensure_ascii=False))


if __name__=='__main__':main()
