"""Generate one development workspace at both existing HTML document paths.
The audit JSON is authored; implementation stages come from development-status.json.
This generator never promotes partial code or test results to original parity.
"""
import argparse
from collections import Counter
import hashlib
import html
import json
from pathlib import Path
import re
ROOT = Path(__file__).resolve().parent
MD_NAME = 'PARSEC_COMPARISON_2026-09-24.ko.md'
HTML_NAME = 'parsec-feature-comparison.html'
PLAN_NAME = 'notparsec-plan.html'
SCOPE = {'product':'제품 기능', 'internal':'내부 전송·처리', 'engineering':'개발·검증',
'server':'자체 서버·운영', 'exception':'명시 변경 요구', 'uncertain':'원본 지원 미확인'}
CODE = {'complete':'☑ 코드 범위 구현', 'partial':'◐ 부분 구현', 'pending':'☐ 미구현'}
PARITY = {'unreviewed':'대조 미완료', 'different':'차이 있음', 'matched':'일치 확인', 'exception_verified':'예외 범위 검증'}
APPLY = {'connected':'◐ 옵션 연결', 'partial':'◐ 일부 연결', 'fixed':'◐ 코드에 고정',
'alternative':'↔ 자체 방식 대응', 'none':'☐ 미구현', 'unconfirmed':'? 미확인'}
UI_STATE = {**APPLY, 'partial':'◐ 부분 구현'}
STAGE = {'complete':'구현 범위 완료', 'partial':'일부 시험/통합', 'pending':'미완료', 'documented':'문서화'}
def read(name): return json.loads((ROOT / name).read_text())
def esc(value): return html.escape(str(value), quote=True)
def cell(value): return str(value).replace('|', '\\|').replace('\n', ' ')
def link(path, label=None): return f'{esc(label or path)}'
def mlink(path, label=None): return f'[{cell(label or path)}]({path})'
def validate_path(path):
target = (ROOT / path).resolve()
if not target.is_relative_to(ROOT.parent) or not target.is_file():
raise ValueError('Missing or unsafe evidence: ' + path)
def model():
plan, ledger, audit, policy = map(read, ['plan-data.json','development-status.json','feature-comparison-audit.json','parity-policy.json'])
settings, ui = read('settings-catalog.json')['settings'], read('ui-text-catalog.json')['flows']
ids = {f['id'] for f in plan['features']}
if ledger['planVersion'] != plan['planVersion']:
raise ValueError('Development ledger and plan versions differ')
if ids != set(ledger['features']) or ids != set(audit['features']):
raise ValueError('Feature coverage must exactly match plan and ledger')
for item in [*ledger['features'].values(), *ledger['milestones']]:
parity = item.get('parity', {})
for evidence in [*item['evidence'], *parity.get('sourceEvidence', []), *parity.get('comparisonEvidence', [])]:
validate_path(evidence['path'])
if set(audit['settingsApplications']) - {s['id'] for s in settings}:
raise ValueError('Unknown setting override')
if set(audit['uiApplications']) - {u['id'] for u in ui}:
raise ValueError('Unknown UI override')
features=[]
for f in plan['features']:
row, a = ledger['features'][f['id']], audit['features'][f['id']]
if a['scope'] not in SCOPE or row['stages']['code'] not in CODE:
raise ValueError('Invalid audit classification')
for path in a['codeEvidence']: validate_path(path)
flows = [u for u in ui if f['id'] in u['features']]
features.append({**a, 'id':f['id'], 'title':f['title'], 'stage':row['stages'], 'plan':f,
'parity':row['parity']['status'], 'state':row['state'],
'evidence':row['evidence'], 'remaining':row['remaining'],
'flows':flows, 'settings':[s for s in settings if s['feature']==f['id']]})
applications=[]
for s in settings:
a=audit['settingsApplications'].get(s['id'],{'state':'none','note':'카탈로그에만 존재. 해당 원본 설정의 실행 연결/조작 UI는 확인되지 않음.','evidence':[]})
if a['state'] not in APPLY: raise ValueError('Invalid setting state')
for path in a['evidence']: validate_path(path)
applications.append({**s,'application':a})
flows=[]
for u in ui:
a=audit['uiApplications'].get(u['id'],{'state':'none','note':'현재 해당 원본 UI 흐름의 구현 없음. 단순 목록/비활성 메뉴는 완료로 세지 않음.'})
if a['state'] not in UI_STATE: raise ValueError('Invalid UI state')
flows.append({**u,'application':a})
counts=Counter(f['stage']['code'] for f in features)
counts['total']=len(features);counts['parityComplete']=sum(f['parity'] in ('matched','exception_verified') for f in features)
provenance={name:hashlib.sha256((ROOT/name).read_bytes()).hexdigest() for name in [
'plan-data.json','development-status.json','feature-comparison-audit.json','settings-catalog.json','ui-text-catalog.json','parity-policy.json']}
return {'features':features,'settings':applications,'ui':flows,'counts':dict(counts),
'checkedAt':audit['checkedAt'],'revision':ledger['revision'],'baseline':policy['baseline'],
'exceptions':policy['exceptions'],'inputSha256':provenance,'plan':plan,'ledger':ledger}
def original_refs(f, markdown=False):
refs=[]
L=mlink if markdown else link
if f['scope'] in ('server','exception','engineering'): refs.append(L('PARSEC_PARITY.ko.md','범위·예외 계약'))
else: refs.append(L('../analysis/parsec/STRUCTURE_ANALYSIS.ko.md','원본 구조 분석'))
if f['flows']:refs.append(L('ui-text-catalog.json', 'UI '+', '.join(u['id'] for u in f['flows'])))
if f['settings']:refs.append(L('settings-catalog.json', f"설정 {len(f['settings'])}개"))
if f['id'] in ('F09','F12','F34','F35','F58'):refs.append(L('PARSEC_CODEC_COMPARISON.ko.md','코덱 함수 대조'))
if f['id'] in ('F05','F09','F12','F13','F14','F26','F35','F68'):refs.append(L('VIDEO_PERFORMANCE.ko.md','성능 계측·가변 bitrate 대조'))
if f['id'] in ('F37','F51'):refs.append(L('CLIPBOARD_AND_IMMERSIVE.ko.md','클립보드·입력 원본 함수 대조'))
if f['id'] == 'F15':refs.append(L('VIDEO_RECOVERY.ko.md','영상 복구 함수·차이 대조'))
if f['id'] in ('F18','F19','F20','F35','F51','F52','F68'):refs.append(L('PARSEC_OVERLAY_COMPARISON.ko.md','메뉴·영상 함수 대조'))
return (' · ' if markdown else '
').join(refs)
def markdown(m):
c=m['counts'];out=[
'# Parsec 비교 · 개발 계획과 구현 현황', '',
f"기준일 {m['checkedAt']} · 상태 {m['revision']} · Windows Parsec {m['baseline']['version']}", '',
f"[실제 구현 상태와 개발 계획]({PLAN_NAME}) · [원본 계약](PARSEC_PARITY.ko.md) · [구현 상태 원장](development-status.json)", '',
f"**{c['total']}개 색인 항목: 코드 범위 구현 {c['complete']} · 부분 구현 {c['partial']} · 미구현 {c['pending']} · 원본 대조 완료 {c['parityComplete']}.**", '',
'82개는 Parsec 전체 기능을 전수 확인한 수가 아니다. 제품 기능과 내부 구조, 자체 서버, 개발·검증 작업을 함께 관리하는 F ID 색인이다. 설정 163개와 UI 흐름 39개는 중복 대응이 있으므로 합산해 구현률을 만들지 않는다.', '',
'03 기능 비교표와 04 개발 계획을 통합했다. HTML은 코드 근거에 따른 구현 상태·검증·남은 작업을 표시한다. 수동 완료 체크·진행 드롭다운·계획 선택 입력은 제거했다. 기존 브라우저 기록은 변경하지 않으며 저장된 기록이 있으면 문서 하단에서 원본 JSON을 내려받을 수 있다.', '',
'## 체크 기준', '',
'- ☑ 코드 범위 구현: 현재 원장의 code 단계가 complete. Windows 실기·원본 일치까지 완료했다는 뜻은 아니다.',
'- ◐ 부분 구현: 실제 연결된 코드가 있으나 기능/설정/원본 동작 일부가 없다.',
'- ☐ 미구현: 해당 범위의 실행 구현이 없다. 설계·카탈로그·비활성 메뉴만으로 체크하지 않는다.',
'- 원본 대조는 별도 판정이다. 코드 구현·자체 시험을 통과해도 원본과 다르면 완료하지 않는다.',
'- 현재 작업 폴더의 소스와 저장된 시험 기록을 감사했다. 실제 Windows 두 PC·GPU·원본 같은 조건 실행은 미검증이며, 이 표는 운영 배포 완료 목록이 아니다.', '',
f"원본 코어 SHA-256: `{m['baseline']['coreSha256']}`. 보관한 정적 분석/디컴파일 의사 코드가 주 근거다. 함수·문자열 존재가 모든 계정/장치에서 실제 동작함을 증명하지 않는다. 이번 작업에서 원본 바이너리를 새로 실행하지 않았다.", '',
'## 전체 기능 비교표', '',
'| ID · 범주 · 기능 | Parsec 원본 | notParsec 현재 구현 | 구현 체크 / 원본 대조 | 근거 |',
'|---|---|---|---|---|']
for f in m['features']:
code=' · '.join(mlink(p) for p in f['codeEvidence']) or '실행 코드 없음 / 조사·시험 자료는 원장 참조'
out.append('| '+ ' | '.join(map(cell,[f"{f['id']} · {SCOPE[f['scope']]} · {f['title']}",f['original'],f['auditNote'],f"{CODE[f['stage']['code']]} / {PARITY[f['parity']]}; 통합: {STAGE[f['stage']['integration']]}",original_refs(f,True)+'; '+code]))+' |')
out += ['', '## 원본 설정 163개: 목록과 실제 적용 구분', '',
'설명에는 카탈로그의 설계 해석이 포함되며, 등록 기본값·범위·참조 근거와 구분한다. 아래 원본 key를 그대로 입력해 사용할 수 있다는 뜻이 아니다. notParsec의 자체 설정/코드에 의미가 연결된 정도다. `코드에 고정`은 사용자 조작 옵션이 아니다. `자체 방식 대응`은 원본 동작 일치가 아니다. 미연결은 제외 승인도 아니다.', '',
'| 원본 key · 기능 | 카탈로그 설명·원본 근거 | 실제 적용 | 현재 동작 / 차이 |', '|---|---|---|---|']
for s in m['settings']:
a=s['application'];out.append('| '+' | '.join(map(cell,[f"`{s['id']}` · {s['feature']}",s['description']+' · '+s.get('evidence','미확인'),APPLY[a['state']],a['note']]))+' |')
out += ['', '## 원본 UI 39개: 화면 흐름별 체크', '',
'원본 카탈로그의 과거 설계 포함/제외 판정을 구현 상태로 사용하지 않는다. 계정 관련 명시 변경은 E01 범위만 인정하며 Teams/Warp 전체를 임의 제외하지 않는다.', '',
'| UI · 기능 | Parsec 원본 흐름 | 현재 체크 / 차이 | 함수 근거 |', '|---|---|---|---|']
for u in m['ui']:
a=u['application'];out.append('| '+' | '.join(map(cell,[u['id']+' '+u['title'],('원본 앵커: ' + ' · '.join(u['anchors'])),UI_STATE[a['state']]+' · '+a['note'],', '.join(u['functions'])]))+' |')
out += ['', '## 명시된 변경과 미확인', '']
for e in m['exceptions']:out += [f"- {e['id']} {e['title']}: {e['boundary']}"]
out += ['', '서버 내부·동적 웹 UI/오류 사전·압축 설치 화면·조건부 기능·다른 버전/OS는 완전 복원되지 않았다. 파일 전송·브라우저 원격 클라이언트 등은 현재 보관본 근거만으로 지원 여부를 확정하지 않는다.', '',
'## 검증 기록과 재생성', '',
'[메뉴·영상 빌드 검증](evidence/overlay-validation.json), [GPU 경로](GPU_VIDEO_AND_UPDATES.ko.md), [UI 원본 근거](UI_TEXT_AUDIT.ko.md). 이번 문서 작업은 새 Windows 실기 시험이 아니다.', '',
'원본은 `feature-comparison-audit.json`·`development-status.json`·기능/설정/UI 카탈로그다. 기존 개발 계획의 사용자 체크·메모는 변경하지 않는다. HTML/Markdown을 직접 수정하지 않고 아래 명령으로 함께 생성한다.', '',
'```bash', 'python3 design/build_feature_comparison.py', 'python3 design/build_plan.py', 'python3 deploy/ubuntu/install-document.py --prepare', '```', '']
return '\n'.join(out)
def table(headers, rows):
return '
| '+esc(h)+' | ' for h in headers)+'
|---|
'+' · '.join(link('#'+f,f) for f in server['featureIds'])+'
'+''.join('기존 설계: '+esc(a['before'])+'
'+esc(a.get('after',''))+'
' for a in server['audit'])+''+esc(item['result'])+'
'+ ' · '.join(link(e['path'],e['label']) for e in item['evidence'])+'
' for item in reversed(m['ledger']['milestones']))+''+link(s['url'],s['title'])+'
'+esc(s['note'])+'
'+esc(p['description'])+'
기존 구현안 · 원본 대조 필요'+esc(p['implementation'])+'
' '완료 기준'+(' · '.join(link('#'+d,d) for d in p['dependencies']) or '없음')+'
' '담당: '+esc(p['module'])+'
재사용: '+esc(p['reuse'])+'
'+esc(p['risk'])+'
' if p['risk'] else '')) cells=[f"{f['id']}{esc(f['title'])}{p['phase']} · {SCOPE[f['scope']]}", ''+esc(f['original'])+'
정적 근거 / 실제 실행 대조 별도', f"{CODE[f['stage']['code']]}"+esc(f['auditNote'])+'
'+ f"설계: {STAGE[f['stage']['design']]}'+original_refs(f)+'
'+esc(s['description'])+'
'+esc(s.get('evidence','미확인'))+''+esc(a['note'])+'
'+''.join(link(p)+''+esc(('원본 앵커: ' + ' · '.join(u['anchors'])))+'
', ''+UI_STATE[a['state']]+''+esc(a['note'])+'
', ''+esc(', '.join(u['functions']))+''+' · '.join(link('#'+f,f) for f in u['features'])+'
'+link('ui-text-catalog.json','원본 문자열·함수 색인')] rows.append(row_html(u['id'],a['state'],'',cells,headers,u['id']+' '+u['title']+' '+('원본 앵커: ' + ' · '.join(u['anchors']))+' '+a['note'])) ui=table(headers,rows) mapping={'__PLAN_UI__':(ROOT/'plan-workspace.js').read_text(), '__PLAN_DATA__':json.dumps(m['plan'],ensure_ascii=False).replace('<','\\u003c'), '__PROGRESS_DATA__':json.dumps(m['ledger'],ensure_ascii=False).replace('<','\\u003c'), '__DESIGN__':design_details(m), '__PHASES__':''.join(f'' for p in m['plan']['phases']), '__CSS__':(ROOT/'feature-comparison.css').read_text(),'__JS__':(ROOT/'feature-comparison.js').read_text(), '__DATE__':esc(m['checkedAt']),'__REVISION__':esc(m['revision']),'__BASELINE__':esc(m['baseline']['version']), '__HASH__':esc(m['baseline']['coreSha256']),'__FEATURES__':features,'__SETTINGS__':settings,'__UI__':ui, '__METRICS__':''.join(f'