1
0
Fork 0
Everything2Everything/docs/research/2026-11-04/agent-completeness.md

14 KiB

전체 후보 완결성 감사

2026-11-04. 조사 후보 R01~R40 전체를 검토했다. 후보는 제품 요구 확정이 아니며 공식 문서의 기능 존재만으로 사용자 수요를 추정하지 않는다. 아래 범위기각은 이번 변환기 개선에 채택하지 않기로 결정을 완료했다는 뜻이다. 검증대기는 구현완료로 계산하지 않는다. 실행 상태는 TASKS.md와 최종 테스트 증거가 우선이다.

채택 및 범위 결정

ID 결정 근거와 완료 판정
R01 채택 개인정보 정책은 기존 옵션의 안전 계약. 메타데이터 회귀와 프리셋 개인정보 문구는 설정 담당 결과에 연결
R02 채택 WebP lossless 프리셋 실제 encoder 전달 결함 재현·수정. assertion RED→38개 관련 GREEN. 다른 포맷의 완전 보존은 약속에서 제외
R03 채택 Q/E 원본 보존·번호소진·동명 경합 작업으로 통합. final suite 결과로 판정
R04 채택 Q01~Q05,Q07,Q09에 통합. 검색 범위 선택·삭제는 공개 command 시나리오 기준
R05 채택 Q06,Q10,Q11,U07에 통합. 취소·결합은 결과 무결성 계약
R06 채택 E05와 CORE process runner 회귀에 통합. 문서 엔진 격리와 timeout 우선
R07 제한채택 기존 파일별 실패 반환 및 잠금/권한 오류 격리 검증. 실제 UNC 서버·네트워크 단절 검증은 별도 환경 증거 없으면 미검증으로 남김
R08 채택 U08. 재사용 옵션 저장·복구는 변환기 핵심. 원격 공유/클라우드 동기화는 범위기각
R09 제한채택 U10,E06. 실제 경로/충돌/파일명 안내 채택. 임의 naming template 언어는 사용자 수요 없어 범위기각
R10 채택 U03,U10,D01. Provider capability와 도구 가용성을 기준으로 설명. 모든 포맷 정보 보존 약속 금지
R11 범위기각 샘플 재변환 비교는 현재 결함 수정과 달리 별도 렌더 취소·캐시·비교 화면 설계 필요. 기존 입력 미리보기와 완료 결과 열기로 사용 흐름 충족. 독립 기능 요청·대표 비교 fixture 없이 확장하지 않음
R12 제한채택 기존 진단·로그+U04/U07. 오류 복사/도움말을 채택. 모든 내부 encoder 파라미터를 제품 화면에 노출하는 전문 디버거는 범위기각
R13 채택 U01~03. 상시 추가/폴더 최상위 정책/지원형식 필터
R14 채택 U05. 등록 상태와 UI 해제, Portable/MSIX 차이 설명
R15 채택 Q08,U06,U09,U11. 실제 고대비/배율/스크린리더 증거는 자동 XAML 통과와 구분
R16 제한채택 완료 결과 열기/폴더 열기·기존 포커스 유지 채택. 자동 메일/종료/알림센터 통합은 수요 없어 범위기각
R17 채택 설정·이력 저장 내구성과 제한. 파일 백업·업데이트 데이터 이관은 별도 실환경 검증 필요
R18 채택 U04,D01 및 릴리즈 안전성. 도움말/현재 문서/버전/의존성 경계
R19 제한채택 CLI wildcard 및 오류·도움말 계약 채택. JSON 자동화 API는 현재 소비자 없어 범위기각
R20 제한채택 기존 timeout·임시정리·parallelism 경계 채택. 모든 압축폭탄을 미리 판별한다는 보장은 불가능하므로 무제한 지원 주장 제외. OS 격리 worker 구조는 별도 아키텍처 작업으로 기각
R21 제한채택 외부 process timeout과 완료 상태 채택. 모든 in-process native crash 격리는 별도 worker 프로토콜/배포 필요해 이번 범위기각. 실제 GPU 가속 표시도 측정 없이 추가하지 않음
R22 제한채택 기존 긴변/방향/종횡비 계약 유지. crop·반전·캔버스 편집은 편집기 범위라 기각
R23 제한채택 ICC/CMYK/HDR 완전 보존 주장은 문서에서 제외. 전문 color-managed pipeline은 타깃 모니터/프로필 실측·사용자 요구 없어 범위기각
R24 제한채택 기존 지원 프레임/알파 계약과 손실 고지 유지. 신규 APNG/애니 WebP/AVIF 확장과 GIF 디더링 편집 UI는 fixture·수요 없어 범위기각
R25 제한채택 Q11 결합 순서·N→1 관계 채택. 페이지 편집·북마크 생성·재배열 편집기는 범위기각
R26 제한채택 PDF 재저장 서명/XFA/PDF/A 손실 고지 채택. PDF 규격 인증·서명 보존/검증기 구현은 전문 제품 범위라 기각
R27 채택 E05·HTML 8개 출력 회귀 유지. 외부 폰트/Office 설치별 픽셀 동일성은 환경 증거 없으면 보장하지 않음
R28 제한채택 WebP 품질/무손실 실제 값 전달과 현재 encoder 옵션 유지. 파일 크기 예측은 데이터별 편차 커서 기각. 전문 CRF/ABR 설명서 전체 복제는 도움말 링크로 대체
R29 채택 T01,D01. assertion 없는 HTML→Markdown 보강, silent readiness pass 제거, 전체 무필터 측정
R30 범위기각 감시 폴더는 쓰기완료 감지·복구·중복 처리 서비스까지 필요. 현재 사용자 요청은 대화형 변환 안정화이며 반복 자동화 수요 증거 없음. CLI 배치 제공
R31 범위기각 레이어/콜라주/워터마크/주석은 작업순서·undo·미리보기 편집기가 필요. 변환기 목적 벗어남
R32 범위기각 FFT·렌즈 보정·CLAHE·형태학은 전문 영상처리 기능. 라이브러리 보유는 제품 수요가 아님
R33 제한채택 기존 RAW/HEIC 읽기 지원을 문서화하되 RAW 현상기 아님을 명시. JXL/C2PA 등 신규 coder는 라이선스·fixture·수요 없으므로 이번 추가 기각
R34 범위기각 자막/트랙/챕터 편집·trim timeline은 미디어 편집기 영역. 기존 FFmpeg 변환·오디오 추출 유지
R35 제한채택 기존 Windows OCR와 언어팩 조건 문서화. 카메라/스캐너/클립보드 관리·언어팩 다운로드 시스템은 하드웨어·권한 경계가 커서 기각
R36 범위기각 PDF 서명·암호·원문 편집은 인증서/권한/보안 검증을 요구하는 별도 제품. 기존 렌더·압축 한계 명시
R37 범위기각 사용자 스크립트 실행은 새 보안 경계. 캐시는 실측 병목/무효화 요구 없이 도입하지 않음. T01은 실제 고정 대기·fixture I/O부터 제거
R38 범위기각 메일 전송/조직 서버는 로컬 변환기 데이터 경계와 어긋남. Portable/MSIX 및 선택 AI의 외부 전송 경계 문서화로 판단 완료
R39 채택 기존 입력 오류 파일별 격리·정상 파일 지속 계약. 확장자만으로 형식 유효성을 보장하지 않음
R40 채택 Q06,Q08,U07·상태 전이·취소/완료/실패/skip 의미·검색 빈 상태로 통합

증거와 남은 게이트

  • 연구: research-a/b 각각100개, validation.json에서 URL/hash 중복0·200개 모두 후보 연결. 독립 사용자 리뷰200개가 아니라 공식 개별 가이드/지원 문서200개다.
  • D01: README의 오래된6개 Provider 한정 설명, 영어 출력 메뉴, Esc·F1 누락, 수동 Provider 등록 설명을 현재 코드에 맞춤. docs/current-features.md에 범위·손실·외부AI 경계를 기록.
  • T01: 정적 HTML fixture의2초 고정 대기를0으로 지정(8개 출력 유지), 작은 viewport, 직접 Provider의 준비실패를 silent pass에서 assertion으로 강화. 제품 기본값은 변경하지 않음. 전체 실행 시간은 최종 TRX로 갱신해야 함.
  • 릴리즈: ReleasePipelineTests는 기존 태그/dirty checkout 거부, force push 금지, native git 실패 확인, 정확한 commit SHA, HTTP 실패와 업로드 크기·URL 검증을 요구한다. 실제 배포는 root 담당.

범위기각을 구현완료로 세지 않는다. 제한채택에서 환경 검증이 없는 부분은 기능 보장으로 승격하지 않는다. 최종 TASKS 상태와 배포 결과는 root의 증거로 확정한다.

이번 세션 TDD 실행 증거

  • test-completeness/safety-red.trx: ReleasePipelineTests2개와 번호소진 seam1개 모두 assertion RED. 스크립트의 checked git/dirty 검사 부재, seam 없음이 원인. 컴파일 실패가 아니다.
  • test-completeness/settings-safety-red.trx: 릴리즈2개 및 설정 담당의 새 테스트2개 assertion RED를 함께 보존. 설정 담당에 결과 전달.
  • test-completeness/safety-html-green.trx: 관련18개 통과, 실패0, skip0, 테스트기간7초. HTML8출력·Markdown 내용·직접 PDF/PNG·번호소진/실제파일 보존·릴리즈계약을 포함한다. 전체 스위트 통과 증거로 사용하지 않는다.
  • 번호소진은 동일 존재판정 계약을 합성 predicate로 검증(원본+1..9999 존재,10000 미존재·검사10001회). 별도 실제2파일 fixture에서 기존 바이트 보존과 다음 번호를 검증한다. 9999파일 생성/삭제 비용을 제거했다.
  • PowerShell parser로 수정 릴리즈 스크립트 문법오류0 확인. Git wrapper의 -c user.name="Yun Chan" 인자 전달을 독립 함수로 확인했다. 실제 push/API 호출은 수행하지 않았다.
  • 릴리즈 스크립트는 dirty checkout·분리HEAD·기존 local/remote tag를 빌드 전 거부한다. 강제 태그 교체를 제거하고 모든 native git 종료코드를 검사한다. commit SHA를 대상에 사용하고 asset 이름·크기·다운로드URL 검증 후 draft를 공개한다. API 실패는 throw하며 성공으로 표시하지 않는다. DryRun은 버전 파일을 수정하지 않는다.
  • 프로파일 목적의 오래된 빌드 전체 실행은 root 요청으로 중단했다. 동시 구현 중인 미연결 RED가 포함됐으므로 최종 성공/성능 판정에 쓰지 않는다. 최종 무필터 새 빌드 측정은 root의 통합 게이트에서 진행한다.

가지치기 및 속도 개선의 계약

  • HTML 실제8출력·Markdown 내용 검증은 유지했다. 직접PDF/PNG 두 Fact는 같은 fixture/동일 결과 assertion의 중복이므로 엔진 theory로 통폐합하고 availability assertion도 옮겼다. 정적 fixture에만 렌더 대기0을 지정했다.
  • 9999파일 생성은 동일 존재판정 predicate로 바꾸고 실제2파일 보존 사례를 별도로 유지했다.
  • ActiveQueueList_Columns_MustProvideAdequateWidthForMetadata의6컬럼 고정 명세는 삭제했다. 실제1280/1080DIP 렌더의 파일명140DIP 확보·툴바 경계·메타데이터 ellipsis와 시각 검토가 그 목적을 검증한다.6컬럼 자체는 사용자 요구가 아니다.
  • TitleBar의260px 상한은 등록해제 버튼 추가로 낡았다. Header/TrailingContent 실제 사각형이 겹치지 않고 titlebar 밖으로 나가지 않는 검사로 대체했다. 큐 요약은 표시/전체 범위가 명확한 새문구를 검증한다.
  • Queue의 FilePickerFilter_IncludesEveryRegisteredInput, HistoryActionsAndRegistrationManagement_AreDiscoverable, ContextMenuManagement_ExplainsCurrentUserAndPackagedScope는 모든 assertion을 PopulatedQueue_ExposesEntryHelpHistoryAndRegistrationActions의 동일 창 사용자 흐름으로 합쳤다. 창3회 생성을 줄였다.
  • IncompatibleQueue_DisablesKeyboardConversionToo의 두 assertion은 RemovingIncompatibleFile_RestoresFormatsAndConversionCommand에서 제거 전 비활성→제거 후 재활성의 전체 시나리오로 합쳤다. 창1회 생성을 줄였다.
  • UI 레이아웃/상태 테스트는 persistHistory:false 생성자 seam으로 실제 사용자 이력읽기·저장과 격리했다. 저장소 내구성/이력 정책 테스트는 별도로 유지한다.
  • 컬렉션 병렬도를4로 제한하고 직렬 비용이 큰Queue/HTML/Core 컬렉션부터 시작한다. 어떤 테스트도 skip/filter로 전체 실행에서 제외하지 않는다. 기본 무제한 병렬은 WPF STA·네이티브 엔진·CSV/XLSX 초기화가 서로CPU를 경쟁해 개별 실행이 수초 늘어났다.

최종 자동 검증과 남은 게이트

  • test-completeness/full-release-final.trx: clean Release 새 빌드, 전체501/501 통과, 실패/경고/건너뜀0. 실제 개별 결과 earliest start/latest end10.735059초, TRX start/finish12.220101초, 빌드+실행 wall19.3925942초다. T01의10초 목표는 아직 미달이다. 3worker 실험은12초로 악화하여4worker를 유지했다. 기록은 final-timing.json에 실패·중간실험을 포함한다.
  • 빈 MainWindow 동일상태의 TitleBar4검사를1창으로, VisualTree 기본badge/기본format/format전환3검사를1창으로 묶고 모든 assertion을 helper에 유지했다. Queue 중복drop→선택/해제→검색0결과/복구도 같은1파일 시나리오로 묶었다. 테스트 수 감소는 중복 fixture 제거이며8출력/오류경계/실파일보존/접근성 검사를 삭제하지 않았다.
  • 테스트가 만드는 모든 WPF Application은 OnExplicitShutdown으로 통일했다. 병렬 창 Close가 Application 자동종료를 일으켜 UIA source가 사라지는 하니스 수명 경합을 막았다. 실제 프로그램의 종료 정책은 바꾸지 않았다.
  • 큐/이력 렌더 결함은 assertion RED 후 root가 XAML을 수정했고, 최종 캡처의1080DIP에서 파일명140DIP·메타데이터·툴바/통계 경계 및 실패 상태를 검증했다. 실제 Narrator/OS 고대비/Per-Monitor 전환은 별도 환경 검증으로 남는다.
  • 이 검증 이후 root가 추가 발견한 기본 프리셋 충돌정책 수정은 별도 RED/GREEN 및 최종 전체 재검증이 필요하다. 이 문서의501 GREEN을 그 후 변경까지 통과한 것으로 해석하면 안 된다.

root 후속 프리셋 통합 RED/GREEN 뒤 최종501/501 통과, 테스트 실행9.5422초. 최종근거는 test-final/release-final-green.trx와 TASKS.md이며 위 child 시점 타이밍을 대체한다.