13 KiB
Core · CLI 정적 감사 — 2026-11-04
범위: ConversionEngine, OutputPathHelper, provider 구현, CLI, 외부 프로세스, 설정·이력, 기존 테스트. 정적 확인과 실제 실행 증거를 구분한다. UI 감사는 별도다.
실행 기준선
dotnet test Everything2Everything.slnx --no-restore --verbosity minimal: NETSDK1112 (Windows SDK 참조팩 미복원).- 복원 포함
dotnet test Everything2Everything.slnx --verbosity minimal: 432 통과 / 0 실패 / 0 건너뜀, 테스트 33초, exit 0. 빌드 경고 출력 없음. - 따라서 기능 회귀 기준선은 GREEN이나 저장소의 전체 스위트 10초 규약은 미충족이다.
할 일과 근거
| ID | 우선순위·상태 | 근거 | 문제·조건·개선·RED |
|---|---|---|---|
| CORE-01 | P1 완료 | ConversionEngine.cs:60 | 빈 sources에서 Math.Clamp(min=1,max=0)가 예외. 빈 큐는 빈 결과 반환. RED: 빈 입력 호출이 예외 없이 빈 배열 반환. |
| CORE-02 | P1 완료 | App/Cli/CliRouter.cs:68-87 | ExpandFiles는 literal File/Directory만 처리, README의 to webp *.png를 지원하지 않는다. wildcard 파일 확장 및 중복 제거. RED: wildcard+명시한 동일 파일은 한 번 선택, 다른 확장자 제외. |
| CORE-03 | P1 완료 | OutputPathHelper.cs:30-37 | AppendNumber 1..9999 소진 후 기존 원본 경로 반환. Magick 등의 쓰기는 기존 파일 덮어쓸 수 있다. 미사용 이름을 계속 탐색 또는 명시 오류. RED: 번호소진 시 기존 파일 경로 반환 금지. |
| CORE-04 | P1 완료·파일별 원자공개 | OutputPathHelper.cs:18-36; ConversionEngine.cs:82-92 | 병렬 변환 시 같은 basename+출력 폴더에 File.Exists 검사와 쓰기 사이 경합. 예: a.png/a.jpg→custom/a.webp. 프로세스 간 예약 또는 CreateNew+원자 commit 필요. RED: barrier로 동명 배치 병렬 실행, 양쪽 내용/독립산출물 보존. |
| CORE-05 | P1 완료 | Converters/DocxProvider.cs:114-159; LibreOfficeRunner.cs:31-118 | DOCX만 shared LibreOfficeRunner를 우회. timeout 없음, stdout/stderr 미배출, 직렬화 없음. 공용 TEMP에 basename.pdf 생성해 동명 문서 병렬 충돌. 고유 작업폴더+Runner로 통합. RED: 동명 DOCX 두 개 및 hang/출력폭주 fake process, timeout·격리 검증. |
| CORE-06 | P1 완료·bundle 정책예외 명시 | Converters/MagickProvider.cs:181-184; HtmlProvider.cs:73,99; FfmpegProvider.cs:82,123,153 | 최종 경로 직접 쓰기/overwrite true. 취소·인코더 실패·디스크 부족 시 기존 출력 손상 또는 부분파일 노출 가능. 같은 볼륨 임시파일→성공검증→원자교체, 실패 정리. RED: 실패/취소 시 기존 출력 바이트 불변. |
| CORE-07 | P2 완료 | Converters/HeicProvider.cs:49-64; DocxProvider.cs:58,105 | 임시 e2e_GUID_basename 파일을 하위 provider에 전달해 최종 출력 basename에 GUID가 새어 나온다. 사용자 원본 stem 유지. RED: HEIC→JPEG, DOCX→PNG 파일명에 원본명+페이지 suffix만 존재. |
| CORE-08 | P2 완료·배치 오류격리 포함 | ConversionEngine.cs:149,163,301 | 가용성 검사 및 Directory.CreateDirectory가 catch 바깥. 권한 없는 custom 폴더나 availability 예외가 파일별 실패 대신 배치 전체를 중단한다. 파일 단위 오류 결과 정규화(취소는 전파). RED: 한 파일 실패 후 후속 파일 계속 처리. |
| CORE-09 | P2 완료 | ConversionEngine.cs:91 vs :73 | 병렬 완료 progress Index=done-1, 순차 완료 Index=i+1. 동일 계약에서 최종 Index가 Total에 도달하지 않는다. progress 의미 통일. RED: 병렬 마지막 progress Index=Total, 단조증가. |
| CORE-10 | P2 완료 | Converters/ExternalProcessRunner.cs:52-65 | stdin 전체 쓰기를 timeout 생성 전에 대기. 자식이 stdin을 읽지 않으면 timeout 미적용 hang 가능. timeout을 process lifecycle 전체에 적용. RED: stdin 미소비 자식+큰 입력도 지정 timeout 안에 종료. |
| CORE-11 | P2 완료·캡처꼬리 상한 | Converters/ExternalProcessRunner.cs:37-40 | stdout/stderr 무제한 StringBuilder 누적. 출력폭주 도구에서 메모리 증가. 상한 있는 로그 꼬리/파일 스트리밍. RED: 대량출력에도 캡처 상한 및 exit 보존. |
| CORE-12 | P2 핵심 완료 | SettingsStore.cs, AtomicPersistence.cs; SettingsPersistenceRegressionTests | 경로별 OS mutex, 디스크 최신 키 병합, 고유 tmp flush 후 교체, 성공 뒤 캐시 갱신. 잠긴 commit·인스턴스 병합·손상파일 보존 assertion RED→GREEN. 읽기 잠금 시 기동 복구/LastLoadError도 검증. 오류는 설정 창에서 보이고 최초 메인 기동 자동 배너는 미연결. |
| CORE-13 | P2 핵심 완료 | HistoryStorage.cs; SettingsCompletionTests; MainWindow history 연결 | 스트리밍 읽기·최근 N개 보존·기록 중지·원자 저장·TryAppend/TryClear/LastError 구현. 이력 실패는 메인 안내, 삭제 성공 후 UI 제거. 보존/중지/삭제 시나리오 및 UI 연결 RED→GREEN. 읽기 잠금 보존 테스트는 최초 PASS. 설정·프리셋 포함 최종20GREEN 근거는 agent-settings-completion.md. 별도 대용량 비용/실제 삭제 권한 실패 UI 실사용 검증은 미수행. |
| CORE-14 | P2 완료 | Converters/OcrProvider.cs:104-110,165-183 | PDF OCR 임시폴더 자체 미삭제, 추출 중 실패/취소는 cleanup try 진입 전 발생해 페이지도 잔류. 작업폴더 전체 finally 정리. RED: PDF 렌더 중 실패/취소 후 잔류폴더 없음. |
| CORE-15 | P2 구현완료·Office 실환경 검증잔여 | Converters/DocxProvider.cs:163-185 | Word COM 동기 호출에 취소·timeout 없음. 기본 병렬 배치에서 COM 아파트/팝업 hang 가능. 전용 STA worker 및 bounded lifecycle 필요. RED: fake COM worker 지연·취소가 큐 전체를 묶지 않음. |
| TEST-01 | P2 대기 | Tests/HtmlEndToEndAllOutputsTests.cs:62-82 | HTML→Markdown 테스트는 결과 로깅만 하고 assertion이 없다. 실패도 GREEN. availability/산출물 내용 중 의도 명시 후 assertion 보강. |
| TEST-02 | P2 대기 | 기준선 33초; Tests/Everything2Everything.Tests.csproj:9 | 10초 규약 위반, 외부 WebView/인메모리 UI/엔진 테스트 섞임. TRX로 비용 측정 후 중복 통폐합·공유 fixture 검토. 느린 검증 삭제로 위장하지 말 것. |
경로는 src/Everything2Everything.Core/ 기준이며 App/Tests는 명시했다. 정적 발견 중 경합·오류경로는 재현 RED 전까지 실제 발생 확률을 단정하지 않는다. 새 기능과 동작 보존 리팩토링을 분리한다.
1차 수정 범위와 불변식
CORE-01~03만 우선 처리한다. 기존 provider 라우팅, 변환 옵션, 사용자 원본, UI를 변경하지 않는다. RED를 확인한 다음 최소 수정하고 타깃 테스트를 GREEN으로 만든다. CLI는 wildcard가 있는 파일명 부분만 확장하고 폴더 재귀는 추가하지 않는다. 번호이름은 기존 번호 규칙을 이어간다.
1차 TDD 증거
- 테스트 파일:
src/Everything2Everything.Tests/BatchInputSafetyTests.cs. - 초기 테스트 컴파일의
System.IO누락은 수정했으며 RED로 계산하지 않았다. - 실제 assertion RED: 빈배치
Assert.Nullexpected null / actual ArgumentException (1 cannot be greater than 0). - 실제 assertion RED: 번호 소진 시
Assert.False(File.Exists(result))실패, 기존photo.png선택. - wildcard 테스트를 강화해 명시파일과 별도 일치파일 두 개를 기대하게 했고, 실제 assertion RED expected 2 / actual 1 확인. 초기에는 명시파일 한 개만 검사해 wildcard 누락을 잡지 못했으므로 보강했다.
- 최소 구현 후 동일 3개 테스트 통과3 / 실패0 / 건너뜀0, 6초.
- CORE-01/02/03은 구현 완료. 번호 소진 검증은 실제 10,000개 임시파일을 만들고 finally에서 지우므로 약6초의 테스트 비용이 있다. 남은 전체 스위트 10초 목표는 별도 TEST-02로 유지한다.
- 병렬 출력 이름 예약(CORE-04)은 이 변경에서 해결했다고 주장하지 않는다.
dotnet test ... --filter BatchInputSafetyTests|EngineCharacterizationTests|RoutingMatrixCharacterizationTests|MatrixIntegrityTests: 33 통과 / 0 실패 / 0 건너뜀, 5초, exit 0.
CORE-04 배치 내 경합 수정
- RED:
ParallelBatch_WithSameOutputNames_PreservesBothContents에서 두 provider 작업이 이름을 선택한 뒤 barrier로 쓰기를 겹쳤다. Expected Success / Actual Failed (IOException: file ... photo.webp ... used by another process) assertion 실패를 확인했다. 실제 파일로 내용과 독립 산출물 두 개를 검증한다. - GREEN:
ConvertManyAsync는 목적지 디렉터리별 입력 인덱스를 그룹화하고 그룹 안은 순차, 서로 다른 폴더는 기존 병렬 한도 안에서 실행한다. 결과 입력 순서는 유지한다. 페이지/프레임 suffix가 있는 provider까지 충돌을 막기 위해 basename보다 보수적인 디렉터리 단위를 선택했다. - 타깃 테스트 통과1 / 실패0, 142ms. CORE-04 상태는 배치 내부 완료 / 프로세스 간 미해결이다.
- 성능 경계: 기본 소스별 출력 하위폴더는 계속 병렬이다. 사용자 지정 단일 출력폴더는 파일 보존을 위해 순차 처리된다. 별도
ConvertManyAsync호출,ConvertOneAsync, 다른 앱 인스턴스나 외부 프로세스와의 경합은 보호하지 않는다. 장기 개선은 원자적 출력 예약·commit이다. - CORE-03의 10,000개 fixture는 번호파일 내용을 쓰지 않고 빈 파일을 생성하도록 줄였다. 실제 File.Exists 기반 재현을 유지하며 기존 원본
photo.png내용은 유지한다.
CORE-04 포함 관련 회귀 최종 게이트: BatchInputSafetyTests + EngineCharacterizationTests + RoutingMatrixCharacterizationTests + MatrixIntegrityTests = 34 통과 / 0 실패 / 0 건너뜀, 3초, exit 0. 빈 번호파일 fixture로 이전 33개 게이트 5초 대비 비용이 줄었다(실행 편차 포함).
후속 완료 상태 — 상단표의 현재 해석
과거 1차 기록은 당시 증거로 유지한다. 현재 CoreSafetyCompletionTests 및 관련 회귀는 test-core/core-completion-green.trx 33/33 통과, 3초이며, 세부 RED와 변경 근거는 agent-core-completion.md에 있다.
- CORE-04/06: Engine 1hop·최종multihop·Combine은 목적지볼륨 staging 성공후 File.Move(overwrite=false)/File.Replace로 공개한다. AppendNumber는 다른 프로세스 선점 시 재선택하므로 별도 ConvertOne 호출도 검증했다. provider 직접 호출에는 엔진보장이 적용되지 않는다. 전체 multipage 원자성 대신 파일별 원자성이며, 이미 공개된 페이지는 후속실패 결과나 취소예외 CompletedResults에 보존한다. sidecar는 전체 bundle 폴더로 함께 공개해 상대참조를 보존한다. Skip은 root/이전bundle primary존재를 검사한다. Overwrite/AppendNumber도 새고유bundle을 반환하는 안전예외이며 결과Message에 고지한다.
- CORE-05/07: Docx는 LibreOfficeRunner와 고유 작업폴더를 사용한다. HEIC/DOCX 중간파일은 고유폴더 안에서 원본 stem을 유지한다. 실제 LO DOC→PNG 및 HEIC adapter의 PNG-payload fixture가 GREEN이다. 후자를 HEIC codec 품질 증거로 해석하지 않는다.
- CORE-08: ConvertOne provider 가용성·출력디렉터리 오류는 Failed로 정규화하고 취소는 전파한다. parallel 목적지 그룹키의 잘못된 경로도 고유group으로 격리해 파일별Failed로 처리하며 NUL custom경로 배치2개 시나리오를 검증했다.
- CORE-09: Index=완료수, FileProgress==1은 이미 Index에 포함. 순차콜백은 동기전달, 병렬콜백은 완료수 증가와 보고를 직렬화해 단조성을 검증했다.
- CORE-10/11: timeout은 stdin쓰기를 포함하며 stdout/stderr 캡처는 각각 마지막32768자로 제한한다. OS/Process의 단일 미개행 line 내부 버퍼까지 절대메모리상한을 보장하지 않는다.
- CORE-14: PDF extraction 자체부터 finally 안에 두고 OCR 작업폴더 전체를 삭제한다. 손상PDF 렌더실패 후 신규 임시폴더 없음 검증. OS cleanup 권한거부는 별도 환경경계다.
- CORE-15: Word COM은 내부 STA 자식worker로 격리해 timeout/cancel을 적용한다. Documents.Open 전 AutomationSecurity=3 적용을 stub로 검증했다. HWND receipt 이후 새 WINWORD PID/starttime 일치만 정리한다. 실제 Word-only 설치환경과 receipt 이전 COM 활성화 hang은 추가 실환경검증 경계다.
Core 최종상태: test-core/core-final-green.trx 36/36 GREEN, 5초. 마지막 sidecar정책 및 parallel invaliddestination 4 assertion RED→GREEN을 포함하며 생산코드범위 종료. 전체통합/10초예산/배포게이트는 root 담당이다.
릴리즈 전 P1 입력집합 보호 완료
다른 큐 원본을 output으로 교차덮어쓰는 결함을 실제파일3시나리오(Independent/Combine/별도engine동시batch) assertion RED로 확인하고 수정했다. InputFileProtection이 프로세스내 전체active source fullpath 집합을 refcount 등록하며, 동일lock에서 최종 publish를 검사해 원본교체를 거부한다. 단건/배치/Combine에 적용하고 모든 종료경로에서 using해제한다. test-core/core-originals-green.trx 관련 41/41 GREEN, 3초. 타프로세스 입력집합 및 hardlink/junction identity별칭은 fullpath기반 보장범위 밖이다. 세부증거는 agent-core-completion.md에 있다.