"""Record the already inspected local captures; never infer whole-game parity."""
import hashlib,json,shutil,subprocess,sys
from pathlib import Path
base=Path('work/visual/galaxy-full').resolve()
utility=Path('C:/Users/XFEstudio/.codex/skills/background-visual-check/scripts/visual_evidence.py')
def sha(path):return hashlib.sha256(path.read_bytes()).hexdigest()
def record(cut,name,requirements,primary,images,preparations,inputs,observations):
if '--only-colonisation-v2' in sys.argv and name!='colonisation-highlight-evidence-v2':return
if '--only-normal' in sys.argv and name!='colonisation-normal-evidence':return
directory=base/cut;out=directory/name
if out.exists():raise RuntimeError('Refusing to overwrite frozen visual review: '+str(out))
out.mkdir();shutil.copyfile(base/requirements,out/'requirements.json')
subprocess.run([sys.executable,str(utility),'register','--image',str(directory/primary),'--target',cut+' '+name,
'--out',str(out/'imported'),'--note','App-owned offline exports; any contact sheet explicitly combines separate fixture states, never one app frame. Matched build metadata and explicit fixture state.'],check=True,capture_output=True)
image_paths=[directory/p for p in images]
evidence=[dict(path=str(p),sha256=sha(p)) for p in image_paths+[directory/p for p in inputs]]
review=dict(capture=str(out/'imported/capture.json'),preparations=[str(directory/p) for p in preparations],
scope=dict(target=cut+' '+name,state='Only the frozen local requirements. Original captures and relevant2x regions actually inspected; source JSON and build metadata cross-checked. Fixtures are labelled synthetic. No current-game or whole-map parity claim.',
identity_confirmed=True,freshness_confirmed=True,coverage_complete=True),
inspected_images=[dict(path=str(p),sha256=sha(p)) for p in image_paths],
checks=[dict(id=k,status='pass',observation=v,evidence=evidence) for k,v in observations.items()])
(out/'review.json').write_text(json.dumps(review,ensure_ascii=False,indent=2)+'\n',encoding='utf-8')
result=subprocess.run([sys.executable,str(utility),'gate','--requirements',str(out/'requirements.json'),
'--review',str(out/'review.json'),'--out',str(out/'verdict.json')],capture_output=True,text=True,encoding='utf-8')
verdict=json.loads((out/'verdict.json').read_text(encoding='utf-8'))
print(json.dumps(dict(cut=cut,review=name,exitCode=result.returncode,status=verdict.get('status'),reasons=verdict.get('reasons')),ensure_ascii=False))
record('interface-35','state-options-evidence','state-options-requirements.json','state-options-after-search.png',
['state-options-all.png','state-options-after-search.png','state-details/options-2x.png'],['state-details/prepare.json'],
['state-options-probe.json','state-ocr.json','result.json','build-metadata.json'],{
'all-options':'原图实际显示繁荣/frontline/无/unpopulated四行，全部选中；原fixture明确四个源identity且排除public-only项。没有把静态21项列表插入原选项。',
'search-edit':'实际控件搜索boom后取消，清空搜索后只有繁荣未勾选，其余三项仍选中；运行时selectedKeys逐项为frontline/none/unpopulated。WinUI退场视觉树与当前逻辑子项已区分，中文显示标签与原key分别核验。',
'layout':'两张完整原图及2x局部中四行文字和独立复选框无重叠/截断；OCR交叉识别frontline、unpopulated和搜索标题，中文标签识别不全，依原图及真实控件文本核验，不将OCR误识当精确文字证明。'})
record('original-data-40','activity-outline-evidence','activity-outline-requirements.json','activity-outline-near.png',
['activity-outline-near.png','range-ring.png','outline-details/outline-2x.png'],['outline-details/prepare.json'],
['power-ring-probe.json','result.json','build-metadata.json'],{
'separate-extent':'实际Main同时提交范围圈1与独立extent4轮廓1；原图看到灰色分段XZ范围圈与青色面向相机轮廓。运行时missing/zero/eye-inside分别为0轮廓，范围圈仍保留。',
'coherence':'运行时对相同范围、不同extent4/5的两个来源明确保留范围圈并抑制任意轮廓；没有随意取第一项。真实坐标与synthetic extent/radius分开记录。',
'source-material':'原图与2x局部显示细青色边缘及内侧原fade，中心为空而非实心替代盘；独立范围圈对照只有灰色分段外圈。此局部证据不证明原游戏同场景整体曝光一致。'})
record('original-data-40','black-hole-background-evidence','black-hole-integration-requirements.json','black-hole-background.png',
['black-hole-background.png','black-hole-background-no-special.png','black-hole-background-details/black-hole-2x.png',
'black-hole-background-comparison/side-by-side.png','black-hole-background-comparison/difference-4x.png'],
['black-hole-background-details/prepare.json'],['black-hole-probe.json','result.json','build-metadata.json'],{
'source-and-scope':'记录真实Byoomao KC-V f2-464、地址249270101213和原坐标；分类41/size.7/RGBA明确为synthetic，不冒充观测黑洞。gameAccess=false且没有生成目录坐标。',
'navigation-gate':'实际Main夹具ShowRoute开/ShowMarkers关提交1个；反向开关提交0个，独立名称/命中仍保留。运行时断言通过，背景开关不改变该分类门槛。',
'classified-gate':'运行时Map+StarClass保留普通分类点且黑洞专用提交0；普通classification4也不进入专用材质。完整probe无failure。',
'strict-hide':'运行时严格空筛及原alpha0分别无模型、标签、命中；strict-empty GPU非黑像素0。高亮/特殊类型没有绕过过滤。',
'near-material':'同一近景24ly、同尺寸银河背景开关对照及2x局部/差异图实际显示小圆形暗心变化，无大光晕或矩形背景擦除；银河背景连续。该对照解决旧全黑背景无法观察矩形擦除的uncertain，旧记录保留不改。'})
record('original-data-41','colonisation-highlight-evidence','colonisation-highlight-requirements.json','colonisation-highlight.png',
['colonisation-highlight.png','colonisation-outside.png','colonisation-highlight-strict-empty.png',
'colonisation-highlight-details/point-2x.png','colonisation-outside-details/point-2x.png',
'colonisation-comparison/side-by-side.png','colonisation-comparison/difference-4x.png'],
['colonisation-highlight-details/prepare.json','colonisation-outside-details/prepare.json'],
['colonisation-highlight-probe.json','colonisation-ocr.json','result.json','build-metadata.json'],{
'source-scope':'真实录制Byoomao GW-W f1-387、地址207931040981和原坐标保持；原分类、资格、范围和RGB均明确synthetic，没有声称这里是观测殖民地，未访问游戏。',
'green-gate':'Main原点shader实测绿色GPU像素207；缺源、范围外、普通Map视图均0绿色像素。范围内与范围外完整原图/2x/并排差异实际呈现绿/灰白变化。',
'strict-hide':'空查询运行时模型/名称/命中均0，原图只剩“当前筛选条件下没有星系”；绿色源不会保留非查询目标。',
'colour-and-layout':'原图与2x中绿色点和Byoomao GW-W f1-387名称清楚、无重叠；范围外同点/名称变为灰白，空筛无恒星/名称。OCR核到Byoomao/GW-W/387，但将f1误为fl；准确名称由原图与实际控件/fixture共同确认。'})
if '--only-colonisation-v2' in sys.argv:
previous=json.loads((base/'original-data-41/colonisation-highlight-evidence/review.json').read_text(encoding='utf-8'))
record('original-data-41','colonisation-highlight-evidence-v2','colonisation-highlight-requirements.json','colonisation-states-contact.png',
['colonisation-highlight.png','colonisation-outside.png','colonisation-highlight-strict-empty.png','colonisation-states-contact.png',
'colonisation-contact-details/green-2x.png','colonisation-contact-details/outside-2x.png','colonisation-contact-details/empty-2x.png'],
['colonisation-contact-details/prepare.json'],['colonisation-contact-sources.json','colonisation-highlight-probe.json','colonisation-ocr.json','result.json','build-metadata.json'],
{c['id']:c['observation']+' Contact为三张分别拍摄的原图1:1区域（上绿色、中范围外、下空筛），所有引用的2x均派生自同一contact；原先跨来源prepare的uncertain记录保留。' for c in previous['checks']})
if '--only-normal' in sys.argv:
record('original-data-43','colonisation-normal-evidence','colonisation-normal-query-requirements.json','normal-states-contact.png',
['colonisation-normal-red.png','colonisation-normal-grey.png','colonisation-highlight.png','colonisation-normal-map-strict.png',
'colonisation-highlight-strict-empty.png','normal-states-contact.png','normal-contact-details/colours-2x.png','normal-contact-details/queries-2x.png'],
['normal-contact-details/prepare.json'],['normal-contact-sources.json','colonisation-highlight-probe.json','result.json','build-metadata.json'],{
'independent-normal':'实际生产控件在同一显式synthetic mode1=0下分别采用mode0=5红色alpha.35和mode0=0原灰；source-mode配对独立证明普通配色/大小的mode0调用及特殊分支1后0顺序。Core回归证明独立尺寸.7*.6、显式null未知、绿分支alpha1不误乘普通alpha.35。',
'normal-colours':'完整原图及同一contact派生2x实际显示红点/红名、灰白点/灰白名，Name为真实记录Byoomao GW-W f1-387，清楚可读；绿色单独一行，未按eligibility0把红/灰变绿。Contact按原比例裁切，不缩放，分别捕获的状态不冒充同帧。',
'map-query':'实际Map视图在mode0非匹配时模型/名称/过滤模型为0且点击无目标，即使mode1=0；画面只剩空筛文字。Core446测试还覆盖公共proof不能复活已知不匹配，且原归属缺失不能借用JournalOwnedColony。',
'strict-and-highlight':'独立绿分支仍有实际207个绿色GPU像素；严格空筛的模型/名称/点击为0，contact末行只有空筛说明。完整probe failure=null且gameAccess=false。'})
"""Record the already inspected local captures; never infer whole-game parity."""
import hashlib,json,shutil,subprocess,sys
from pathlib import Path
base=Path('work/visual/galaxy-full').resolve()
utility=Path('C:/Users/XFEstudio/.codex/skills/background-visual-check/scripts/visual_evidence.py')
def sha(path):return hashlib.sha256(path.read_bytes()).hexdigest()
def record(cut,name,requirements,primary,images,preparations,inputs,observations):
if '--only-colonisation-v2' in sys.argv and name!='colonisation-highlight-evidence-v2':return
if '--only-normal' in sys.argv and name!='colonisation-normal-evidence':return
directory=base/cut;out=directory/name
if out.exists():raise RuntimeError('Refusing to overwrite frozen visual review: '+str(out))
out.mkdir();shutil.copyfile(base/requirements,out/'requirements.json')
subprocess.run([sys.executable,str(utility),'register','--image',str(directory/primary),'--target',cut+' '+name,
'--out',str(out/'imported'),'--note','App-owned offline exports; any contact sheet explicitly combines separate fixture states, never one app frame. Matched build metadata and explicit fixture state.'],check=True,capture_output=True)
image_paths=[directory/p for p in images]
evidence=[dict(path=str(p),sha256=sha(p)) for p in image_paths+[directory/p for p in inputs]]
review=dict(capture=str(out/'imported/capture.json'),preparations=[str(directory/p) for p in preparations],
scope=dict(target=cut+' '+name,state='Only the frozen local requirements. Original captures and relevant2x regions actually inspected; source JSON and build metadata cross-checked. Fixtures are labelled synthetic. No current-game or whole-map parity claim.',
identity_confirmed=True,freshness_confirmed=True,coverage_complete=True),
inspected_images=[dict(path=str(p),sha256=sha(p)) for p in image_paths],
checks=[dict(id=k,status='pass',observation=v,evidence=evidence) for k,v in observations.items()])
(out/'review.json').write_text(json.dumps(review,ensure_ascii=False,indent=2)+'\n',encoding='utf-8')
result=subprocess.run([sys.executable,str(utility),'gate','--requirements',str(out/'requirements.json'),
'--review',str(out/'review.json'),'--out',str(out/'verdict.json')],capture_output=True,text=True,encoding='utf-8')
verdict=json.loads((out/'verdict.json').read_text(encoding='utf-8'))
print(json.dumps(dict(cut=cut,review=name,exitCode=result.returncode,status=verdict.get('status'),reasons=verdict.get('reasons')),ensure_ascii=False))
record('interface-35','state-options-evidence','state-options-requirements.json','state-options-after-search.png',
['state-options-all.png','state-options-after-search.png','state-details/options-2x.png'],['state-details/prepare.json'],
['state-options-probe.json','state-ocr.json','result.json','build-metadata.json'],{
'all-options':'原图实际显示繁荣/frontline/无/unpopulated四行，全部选中；原fixture明确四个源identity且排除public-only项。没有把静态21项列表插入原选项。',
'search-edit':'实际控件搜索boom后取消，清空搜索后只有繁荣未勾选，其余三项仍选中；运行时selectedKeys逐项为frontline/none/unpopulated。WinUI退场视觉树与当前逻辑子项已区分，中文显示标签与原key分别核验。',
'layout':'两张完整原图及2x局部中四行文字和独立复选框无重叠/截断；OCR交叉识别frontline、unpopulated和搜索标题，中文标签识别不全，依原图及真实控件文本核验，不将OCR误识当精确文字证明。'})
record('original-data-40','activity-outline-evidence','activity-outline-requirements.json','activity-outline-near.png',
['activity-outline-near.png','range-ring.png','outline-details/outline-2x.png'],['outline-details/prepare.json'],
['power-ring-probe.json','result.json','build-metadata.json'],{
'separate-extent':'实际Main同时提交范围圈1与独立extent4轮廓1；原图看到灰色分段XZ范围圈与青色面向相机轮廓。运行时missing/zero/eye-inside分别为0轮廓，范围圈仍保留。',
'coherence':'运行时对相同范围、不同extent4/5的两个来源明确保留范围圈并抑制任意轮廓；没有随意取第一项。真实坐标与synthetic extent/radius分开记录。',
'source-material':'原图与2x局部显示细青色边缘及内侧原fade，中心为空而非实心替代盘；独立范围圈对照只有灰色分段外圈。此局部证据不证明原游戏同场景整体曝光一致。'})
record('original-data-40','black-hole-background-evidence','black-hole-integration-requirements.json','black-hole-background.png',
['black-hole-background.png','black-hole-background-no-special.png','black-hole-background-details/black-hole-2x.png',
'black-hole-background-comparison/side-by-side.png','black-hole-background-comparison/difference-4x.png'],
['black-hole-background-details/prepare.json'],['black-hole-probe.json','result.json','build-metadata.json'],{
'source-and-scope':'记录真实Byoomao KC-V f2-464、地址249270101213和原坐标；分类41/size.7/RGBA明确为synthetic，不冒充观测黑洞。gameAccess=false且没有生成目录坐标。',
'navigation-gate':'实际Main夹具ShowRoute开/ShowMarkers关提交1个；反向开关提交0个，独立名称/命中仍保留。运行时断言通过，背景开关不改变该分类门槛。',
'classified-gate':'运行时Map+StarClass保留普通分类点且黑洞专用提交0；普通classification4也不进入专用材质。完整probe无failure。',
'strict-hide':'运行时严格空筛及原alpha0分别无模型、标签、命中；strict-empty GPU非黑像素0。高亮/特殊类型没有绕过过滤。',
'near-material':'同一近景24ly、同尺寸银河背景开关对照及2x局部/差异图实际显示小圆形暗心变化，无大光晕或矩形背景擦除；银河背景连续。该对照解决旧全黑背景无法观察矩形擦除的uncertain，旧记录保留不改。'})
record('original-data-41','colonisation-highlight-evidence','colonisation-highlight-requirements.json','colonisation-highlight.png',
['colonisation-highlight.png','colonisation-outside.png','colonisation-highlight-strict-empty.png',
'colonisation-highlight-details/point-2x.png','colonisation-outside-details/point-2x.png',
'colonisation-comparison/side-by-side.png','colonisation-comparison/difference-4x.png'],
['colonisation-highlight-details/prepare.json','colonisation-outside-details/prepare.json'],
['colonisation-highlight-probe.json','colonisation-ocr.json','result.json','build-metadata.json'],{
'source-scope':'真实录制Byoomao GW-W f1-387、地址207931040981和原坐标保持；原分类、资格、范围和RGB均明确synthetic，没有声称这里是观测殖民地，未访问游戏。',
'green-gate':'Main原点shader实测绿色GPU像素207；缺源、范围外、普通Map视图均0绿色像素。范围内与范围外完整原图/2x/并排差异实际呈现绿/灰白变化。',
'strict-hide':'空查询运行时模型/名称/命中均0，原图只剩“当前筛选条件下没有星系”；绿色源不会保留非查询目标。',
'colour-and-layout':'原图与2x中绿色点和Byoomao GW-W f1-387名称清楚、无重叠；范围外同点/名称变为灰白，空筛无恒星/名称。OCR核到Byoomao/GW-W/387，但将f1误为fl；准确名称由原图与实际控件/fixture共同确认。'})
if '--only-colonisation-v2' in sys.argv:
previous=json.loads((base/'original-data-41/colonisation-highlight-evidence/review.json').read_text(encoding='utf-8'))
record('original-data-41','colonisation-highlight-evidence-v2','colonisation-highlight-requirements.json','colonisation-states-contact.png',
['colonisation-highlight.png','colonisation-outside.png','colonisation-highlight-strict-empty.png','colonisation-states-contact.png',
'colonisation-contact-details/green-2x.png','colonisation-contact-details/outside-2x.png','colonisation-contact-details/empty-2x.png'],
['colonisation-contact-details/prepare.json'],['colonisation-contact-sources.json','colonisation-highlight-probe.json','colonisation-ocr.json','result.json','build-metadata.json'],
{c['id']:c['observation']+' Contact为三张分别拍摄的原图1:1区域（上绿色、中范围外、下空筛），所有引用的2x均派生自同一contact；原先跨来源prepare的uncertain记录保留。' for c in previous['checks']})
if '--only-normal' in sys.argv:
record('original-data-43','colonisation-normal-evidence','colonisation-normal-query-requirements.json','normal-states-contact.png',
['colonisation-normal-red.png','colonisation-normal-grey.png','colonisation-highlight.png','colonisation-normal-map-strict.png',
'colonisation-highlight-strict-empty.png','normal-states-contact.png','normal-contact-details/colours-2x.png','normal-contact-details/queries-2x.png'],
['normal-contact-details/prepare.json'],['normal-contact-sources.json','colonisation-highlight-probe.json','result.json','build-metadata.json'],{
'independent-normal':'实际生产控件在同一显式synthetic mode1=0下分别采用mode0=5红色alpha.35和mode0=0原灰；source-mode配对独立证明普通配色/大小的mode0调用及特殊分支1后0顺序。Core回归证明独立尺寸.7*.6、显式null未知、绿分支alpha1不误乘普通alpha.35。',
'normal-colours':'完整原图及同一contact派生2x实际显示红点/红名、灰白点/灰白名，Name为真实记录Byoomao GW-W f1-387，清楚可读；绿色单独一行，未按eligibility0把红/灰变绿。Contact按原比例裁切，不缩放，分别捕获的状态不冒充同帧。',
'map-query':'实际Map视图在mode0非匹配时模型/名称/过滤模型为0且点击无目标，即使mode1=0；画面只剩空筛文字。Core446测试还覆盖公共proof不能复活已知不匹配，且原归属缺失不能借用JournalOwnedColony。',
'strict-and-highlight':'独立绿分支仍有实际207个绿色GPU像素；严格空筛的模型/名称/点击为0，contact末行只有空筛说明。完整probe failure=null且gameAccess=false。'})
