# Core 안전성 후속 구현 증거 범위: ConversionEngine, OutputPathHelper, OutputTransaction, provider adapters, 외부프로세스 수명. UI/설정/이력/프리셋은 다른 세션 소유다. 커밋·배포하지 않았다. ## RED → GREEN 1. CoreSafetyCompletionTests 초기 5개 assertion RED: - 실패/취소 encoder가 기존 출력에 `source`를 써서 expected `previous successful result`와 불일치(2개). - 동시 ConvertOne 두 개 중 하나가 IOException으로 Failed 또는 같은 이름 선택. - 파일이 가로막은 출력디렉터리에서 expected no exception / actual IOException. - 외부 stdout expected <=32768 / actual200002. 2. 최소 구현: 같은 볼륨 목적지 안의 고유 `.e2e-stage-*`에 provider 출력 → 성공 후만 final 경로 공개. 기존 파일은 File.Replace, 새파일은 overwrite=false File.Move. AppendNumber 경합은 이름 재선택. 실패·취소 staging 정리. ConvertOne 경로/가용성 오류는 Fail로 정규화(취소 전파). 3. 관련 20개(CoreSafety 초기5 + BatchInputSafety4 + EngineCharacterization11) GREEN, 실패0, 8초. 4. 추가 assertion RED: - 취소배치 exception에 완료결과가 없어 CompletedResults expected non-null / actual null. - 병렬 final progress expected2 / actual1. - stdin 미소비 child에서100ms timeout이 적용되지 않아2초 safety cancellation 예외. 5. 구현: BatchConversionCanceledException.CompletedResults(처리된 성공/실패/skip 결과, 입력순서), 완료progress Index=done, stdin쓰기에도 linked timeout 적용. GREEN은 후속 슬롯에서 확인한다. 최초 GREEN시도는 다른 세션 ReleasePipelineTests.cs:36 CS1012 컴파일오류로 막혀 동작 실패로 계산하지 않았다. ## 출력 안전성 계약 - 앱의 ConversionEngine 1hop/마지막multihop/Combine 경계에서 적용된다. provider를 직접 호출하는 라이브러리 사용에는 이 엔진계약이 자동적용되지 않는다. - 새 파일 공개는 File.Move(overwrite=false), 기존 파일 교체는 File.Replace로 기존 파일을 먼저 삭제하지 않는다. 다른 프로세스가 이름을 선점하면 AppendNumber가 다음 번호를 선택한다. - 원본과 최종경로가 같으면 덮어쓰기를 거부한다. 사용자 원본을 인코더 실패로 훼손하지 않는다. - 다중페이지 변환의 파일별 공개는 원자적이나 전체 페이지 묶음의 단일 트랜잭션은 아니다. 디스크·권한 오류가 후반 commit에서 발생하면 앞서 성공한 페이지는 남을 수 있다. 검증 없이 전체 all-or-none을 주장하지 않는다. - staging 생성/쓰기 실패는 읽기 쉬운 파일별 실패로 전달된다. OS가 cleanup 자체를 거부한 상황의 잔류까지 완전 보장하지 않는다. - provider가 기존 출력을 skip할지 여부는 final commit 시점에 판정하므로 skip 작업도 encode 비용이 들 수 있다. ## Word-only 프로세스 격리 root의 내부worker 진입구 assertion RED 확인 뒤 구현했다. `RunWordWorker(source,target)`는 absolute 원본.doc/.docx 존재, 대상.pdf 미존재, 대상부모폴더 존재를 검사한다. 부모는 현재 apphost의 `internal-word-pdf` verb를 ExternalProcessRunner로 실행해 timeout/cancel/tree kill을 적용한다. COM은 자식 STA worker에서만 호출한다. COM이 RPCSS를 통해 WINWORD를 생성하면 단순 프로세스트리 kill에 안 잡힐 수 있으므로 worker가 HWND→PID/starttime receipt를 기록한다. 부모는 시작전 존재하던 Word PID를 제외하고 processName/starttime 일치하는 새 Word만 정리한다. 이미 실행 중인 사용자의 Word 문서를 종료하지 않는다. 실제 Word-only Office 환경의 검증과 일반 도구 timeout 검증은 구분한다. ## 연구 후보 범위판단 - R03: 출력충돌/원본보존/부분파일 노출은 직접 재현된 기존 결함이므로 위 engine 경계에서 수정. - R20: 실패취소 임시정리, 외부로그 상한, timeout은 기존 흐름의 안전성 수정. 압축폭탄 한도·최대픽셀·HTML 네트워크 정책은 지원범위를 바꾸는 별도 정책으로, 임의 수치로 정상 전문파일을 거부하지 않는다. 실제 자원측정과 사용자 목적에 맞춘 한도를 별도 기록해야 한다. - R21: 외부 Word worker는 bounded lifecycle로 격리. 네이티브 Magick 전체 sandbox는 현 변경이 아니며 native access violation까지 앱을 보호했다고 주장하지 않는다. - R27: DOCX 공용runner/고유작업폴더/원본stem 및 OCR 정리가 후속 RED 대상. HTML dispatcher flaky는 timing 보고서에 근거를 유지한다. ## 후속 검증 완료 `test-core/core-safety-green.trx`: CoreSafetyCompletionTests + ExternalProcessRunnerTests + EngineCharacterizationTests **27/27 통과, 실패0, 5초**. stdin timeout, 완료결과 취소 전달, 진행률 최종값/순서, 실패·취소 기존파일 보존, 동명 병렬 공개, 원본stem HEIC adapter, 실제 LibreOffice DOC→PNG 원본stem, 손상PDF OCR 임시폴더 정리를 포함한다. HEIC fixture는 PNG payload의 adapter 경로 검증이며 HEIC codec 품질을 입증하지 않는다. 추가 RED 근거: 어댑터4개 실패(`core-adapters-red.trx`), 순차 완료progress expected Index1 / actual0. 수정 뒤 위 통합 GREEN으로 검증했다. 따라서 앞의 5번 GREEN대기와 R27 후속예정 상태는 이 결과로 갱신한다. Progress 계약: Index는 완료파일 수다. FileProgress==1은 해당 파일이 Index에 이미 포함된다. 0
_files_