feat: release Find-Word v0.2.3

2026-10-14 10:01:46 +00:00
parent c92660b514
commit 812540c743
531 changed files with 103693 additions and 325 deletions
@@ -0,0 +1,76 @@
+# Find-Word 변경 이력
+
+## 0.2.3 — 2026-10-14 (로컬 구현, 배포 미실행)
+
+- 라운드를 정확히 3문항으로 변경하고 한 단계의 난이도를 유지한다. 시작 단계 1~5 선택,
+  정상 완료 후 다음 단계 새 라운드, 5단계 재도전을 제공한다. 혼합 모드는 선택/입력을 모두 포함한다.
+- SNR 직접 제어: −12~+12 dB, 1 dB 간격, 범위/NaN 정규화. 재생 중 변경은 다음 청취부터 적용,
+  이후 문항/라운드에 유지하고 홈 복귀 시 단계 기본값으로 초기화한다. 양/0/음수의 의미를 설명한다.
+- 중도 종료는 fetch·Web Audio·타이머를 즉시 취소하고 응답/정답 수를 보여 준 뒤 홈으로 연결한다.
+  무응답을 오답으로 세지 않고 지연 콜백·중복 답변을 차단한다.
+- 절차적 배경 합성을 제거하고 실제 현장 녹음 8개를 same-origin WAV로 번들한다.
+  각 12초·24kHz mono PCM16·50ms fade·안전 선형 정규화·고유 SHA-256, 원본은 번들하지 않는다.
+- PD/CC0/CC BY 4.0/CC BY-SA 4.0 원본을 추적하는 machine-readable manifest와 브라우저 배포 고지.
+  시장 파생본의 ShareAlike와 지하철 credit/변경 고지 유지. 원본/다운로드 URL·저작자·변환·해시·실측값 기록.
+- 녹음을 fetch/decode/loop하며 RMS .03 정규화 후 상대 gain을 적용한다. 공통 peak 감쇠로 SNR을
+  유지하면서 clipping headroom을 확보한다. 404/decode/timeout/abort는 재시도 가능한 한국어 안내를 제공한다.
+- 회귀 수정: 세 문항 표본에 맞게 전체 콘텐츠 도달성 검사 확대; 콘텐츠의 Node 직접 import 경로 보존;
+  재생 중 SNR 변경이 실제 청취 이력을 덮어쓰지 않도록 결과에 청취 시작값 기록.
+- 추가 회귀 수정: 3문항에서도 순환 환경이 여덟 장소에 도달하도록 섞고, 결과의 잘못된 플레이 방법 앵커를 제거한다.
+  세 문항의 문항별 보너스 상한(20점)과 라운드 합계 상한(30점)을 안내하고 새 단계/SNR 컨트롤의 44px 터치 영역을 보장한다.
+  개발/preview에서 HTML Accept가 있는 누락 WAV도 SPA fallback 대신 404로 응답한다.
+  모바일 시작 단계 선택값의 잘림을 막도록 중복 SNR을 별도 제어에 모았다.
+  내장 SVG favicon으로 Chrome의 기본 favicon.ico 404 콘솔 오류를 제거한다.
+- 기존 10 mechanic·100문장·101 neural WAV, 채점·점수·IME·재청취·음량·접근성·개인정보 미수집을 보존한다.
+- package/lock/HTML/UI/manifest/문서를 0.2.3으로 정렬하고 음원 query 버전을 갱신한다.
+  `Designed by OZ at Heat-T Medical Inc.`와 v0.1/v0.1.1 역사 evidence는 보존한다.
+- strict vertical-slice TDD RED/GREEN, Python 변환 계약, 빌드 자산/notice 검증,
+  sandboxed system Chrome desktop/mobile의 실제 WAV decode/playback·스크린샷·axe·네트워크 검사를 수행한다.
+  정확한 실행 결과와 추가 회귀는 `.agent/RESULT-v0.2.3.md`에 기록한다.
+- Nginx 현장음 404와 원자 배포/rollback 인계 문서를 갱신한다. commit/push/merge/tag/배포는 Neo 인수 이후 별도 작업이다.
+
+### v0.2.3 독립 리뷰 수정
+
+- 진행 막대를 현재 문항 1/3·2/3·3/3으로 정정하고 접근성 값 및 Chrome 실제 채움 픽셀을 검사한다.
+- 보너스 문구를 문항별 최대 20점 / 라운드 합계 0+10+20=30점으로 정정한다. 1단계 만점 330점과 함께 검증한다.
+- 무응답 정답률은 `— / 응답 없음`, 응답 없는 단계는 `미진행`; 중도 종료와 현재 단계 완료 제목을 구분한다.
+- 320px·360px에서 모드 설명과 결과의 한국어 어절 분리·넘침을 방지한다. README 현재 증거 경로를 고치고 일본어 테스트 제목을 한국어로 바꾼다.
+- 음성 manifest/폴더를 함께 축약해도 실패하도록 콘텐츠 기반 정확한 101개 목록, 개수 및 dist 추가/누락 파일을 검사한다.
+- 현장음 승인 계획/manifest의 임시 경로를 불변 원본 해시·bytes·검증 상태 및 정확한 직접 미디어 길이로 교체한다.
+- 현장음 생성 전 여덟 원본의 승인 해시·bytes를 전수 확인한다. 잘못된 원본은 첫 변환 전에 실패한다.
+- 같은 파일시스템 staging에서 8 WAV·manifest·notice 전부 검증 후 Linux 원자 디렉터리 교환. stale 파일 제거,
+  symlink 출력 거부, 변환·쓰기·검증·교환 실패/중단 시 이전 디렉터리 보존을 테스트한다.
+- 고지를 `/ambience/AMBIENCE_NOTICES.md`로 옮겨 함께 발행하고 각 항목의 creator/primary URL/direct URL/
+  license URL/outputLicense/변경 설명을 빌드에서도 강제한다. UI 링크와 권리·배포·재현 문서를 갱신한다.
+- 101 voice + 8 ambience WAV 바이트와 모든 이전 evidence를 보존한다. 이번 리뷰의 RED/GREEN과 전체 실행 결과는
+  `.agent/evidence-v0.2.3/review-fixes/` 및 `.agent/RESULT-v0.2.3.md`를 참조한다. 사람의 청취 인수는 미실행이다.
+
+### v0.2.3 최종 privacy excerpt refinement
+
+- 모든 현장음의 `selectedSegmentStartSeconds`를 승인 계획의 불변 provenance로 고정한다.
+  생성기의 별도 시작점 map을 제거하고 manifest/notice/build/browser에서 계획과 구간 범위를 대조한다.
+- mall 36–48초, market 60–72초, cafe 180–192초로 변경하고 다른 다섯 구간은 유지한다.
+  원본 8개 해시 확인 후 전체 ambience 디렉터리를 원자 재생성한다. 101 voice와 다섯 ambience WAV는 바이트 동일하다.
+- Ogg seek/timestamp로 짧아진 PCM은 전체 디코드 후 sample 기준으로 정확한 12초를 선택한다.
+  패딩/시간 변형 없이 실제 seek 경로를 기록하고 부족한 원본은 거부한다. 실패 시 이전 bundle 보존을 재확인했다.
+- Neo의 이전 후보 scan과 파생본 ASR을 원문 그대로 보존하고 출처·설정 누락·휴리스틱 text의 한계를 기록한다.
+  최종 8 WAV의 faster-whisper 1.2.1 tiny multilingual 검사와 모든 추가 실패/성공 근거는
+  `.agent/evidence-v0.2.3/privacy-screening/`에 보존한다. **ASR은 screening signal이며 사람의 청취 인수나 법적/개인정보 clearance가 아니다.**
+- 최종 VAD-enabled ASR은 mall 0 / market 3 / cafe 1 segment를 반환하여 요청한 zero-segment 기준은 **미달**이다.
+  VAD 미사용 결과도 별도로 보존하고 새 acceptance test는 실패 상태를 유지한다.
+- 이전 evidence는 변경하지 않는다. 최종 검증/상세 결과는 `.agent/RESULT-v0.2.3.md`의 마지막 절을 참조한다.
+
+## 0.1.1 — 2026-10-14
+
+- Microsoft Edge online TTS `ko-KR-HyunsuMultilingualNeural`, edge-tts 7.3.1,
+  rate −6%, pitch −4Hz로 안내 1개·목표 100개를 새로 생성하고 24kHz mono PCM16으로 변환했다.
+- pinned venv, bounded retry/timeout, 원자 자산 교환, provider/도구/출력물의 권리 구분과 provenance를 추가했다.
+- query cache-busting, 시스템 Chrome sandbox 기본 활성화, 화면·음량·한국어 제목과 SNR 설명의 검증을 보강했다.
+- 원본 기록: [.agent/RESULT-v0.1.1.md](.agent/RESULT-v0.1.1.md), `.agent/evidence-v0.1.1/`.
+
+## 0.1.0 — 2026-10-14 (당시 UI 표기 v0.1)
+
+- 반응형 시작/게임/결과, 열 문항·다섯 단계, 객관식/주관식/혼합, 10 mechanic·100문장.
+- 점수·연속 정답·재청취·IME 보호·접근성·동시 재생/취소/실패 복구, 여덟 합성 배경.
+- 정적 SPA, 개인정보 저장·외부 런타임 요청 없음, 정확한 credit 및 private 프로젝트 권리 고지.
+- 원본 기록: [.agent/RESULT.md](.agent/RESULT.md), `.agent/evidence/`.