아바타 v3 공개 웹 반영 기록

docs/TODO.md

@@ -27,7 +27,7 @@
 | ADMIN-OPENROUTER-001 | 새 사용자 OAuth finish 성공을 관측한다. | API/web 복구·실제 PostgreSQL rollback·배포/보존 census·공개 관리자 UI를 수용했다. OpenRouter UI 상태는 미연결이고 health의 Jev `live_verified=false`는 live 검증이 아니며, 새 OAuth finish 성공 관측 전까지 진행 중이다. [운영 영수증](./ops/evidence/admin-openrouter-recovery-2026-09-22.json)을 따른다. |
 | JEV-001 | 충분한 한국어 독립 평가와 전체 지연 반복 비교를 마친다. | 운영 API, 합성·인증 브라우저 3턴 runtime과 DB 감정 영속화는 수용했지만 품질 승격은 보류한다. API legacy baseline 1191 passed·1 skipped·0 failed, gateway 82 passed는 구현 회귀 증거이며 품질·성능 우위 증거가 아니다. 위 품질 게이트를 닫은 뒤 전체 사용자 흐름 완료 여부를 판단하며, 최신 probe·수용/반려 근거는 [Jev 결정문](./decisions/jev-client-affect.md)을 따른다. |
 | JEV-002 | v2 평가·표현 프로토콜을 운영에 올리고 실제 대사 영향을 관측한다. | 로컬 구현·실 Jev 16/16·실 DB RLS 15항목·실 스택 레이아웃을 수용했다. 운영은 migration 24를 먼저 적용한 뒤 API·web을 배포한다(스키마 없이 배포하면 readiness가 기동을 막는다). 로컬 `claude_cli` 생성 엔진 시간 초과로 v2 지시가 실제 대사에 미치는 영향은 미관측이다. 보정 관찰(`a_understood` 문구, `a_sore_spot` 과다 선택)은 전문가 검토 대상이다. [v2 프로토콜](./decisions/jev-client-affect-v2.md) |
-| AVATAR-V3 | 가상 내담자 아바타 v3(표현 엔진·반응 모션·리노컷 리그)를 P1부터 세션에 연결한다. | 1단계 엔진·`/dev/avatar-lab` 수용(check:avatar-presets 통과·E2E 6 passed), 2단계-A P1 리노컷 레이어 수용. 2단계-B-1b 렌더러 기능 계약·B-1c 모티프 수용. 진행: 2단계-B-1d 표정 판독성 개정(입술 결 래스터, 눈썹 중심선 랜드마크, 이마 주름, 작은 크기 선 보정)과 발화층 립싱크(한글 비짐 + 오디오 선분석, 결정문 §5.4 — 구현·검증됨), 발화 동반층 §5.5·하관 띠 변형(턱·코·볼)·원화 픽셀 입술 구현, 2단계-B-1d 수용(소유자 시각 확인 대기). 2단계-B-2 세션 연결 수용(master `613bcb60`, 공개 웹 반영은 소유자 실행 대기). 남음: 공개 웹 반영·소유자 시각 확인, 3단계 API `avatar_cue`·지문 어휘 가이드, 4단계 7명 외형 SSOT. [결정문](./decisions/avatar-expression-engine-v3.md) |
+| AVATAR-V3 | 가상 내담자 아바타 v3(표현 엔진·반응 모션·리노컷 리그)를 P1부터 세션에 연결한다. | 1단계 엔진·`/dev/avatar-lab` 수용(check:avatar-presets 통과·E2E 6 passed), 2단계-A P1 리노컷 레이어 수용. 2단계-B-1b 렌더러 기능 계약·B-1c 모티프 수용. 진행: 2단계-B-1d 표정 판독성 개정(입술 결 래스터, 눈썹 중심선 랜드마크, 이마 주름, 작은 크기 선 보정)과 발화층 립싱크(한글 비짐 + 오디오 선분석, 결정문 §5.4 — 구현·검증됨), 발화 동반층 §5.5·하관 띠 변형(턱·코·볼)·원화 픽셀 입술 구현, 2단계-B-1d 수용(소유자 시각 확인 대기). 2단계-B-2 세션 연결 수용·운영 반영(master `613bcb60`, 공개 웹 Pages `dd96c2d5`, 2026-10-01). 남음: 운영 화면 소유자 시각 확인, 3단계 API `avatar_cue`·지문 어휘 가이드, 4단계 7명 외형 SSOT. [결정문](./decisions/avatar-expression-engine-v3.md) |
 | USER-LATENCY (JEV-001) | 실제 경로에서 text display·voice onset·완료 준비를 분리 측정한다. | 안전 검사를 유지한 최적화 뒤 반복 비교로 사용자 체감 지연을 평가한다. 현재 CUA 관측상한과 소수 audit은 속도 개선 증거가 아니다. |
 | G6-PRODUCER-CONFLICT | 기존 submission id와 content hash를 읽기 전용으로 대조한다. | `SupervisionResearchConflictError`의 동일 id 재실행 idempotency 충돌을 해소하고 해당 테스트와 실제 cycle 성공을 확인한다. Jev·세션 경로와 분리된 기존 운영 충돌이며, 이번 배포 회귀로 단정하지 않는다. |
 | VNET-001 | `vnet.18ka.net` 공개 전환의 외부 설정을 마친다. | DNS, Cloudflare zone 권한, Google redirect URI가 모두 준비된 뒤 live 검증. |

docs/decisions/avatar-expression-engine-v3.md

@@ -587,7 +587,11 @@ type Performance = {
     - check:duplication 실패는 apps/api 파이썬 기존 중복 때문이다. 이 작업은 apps/api 변경이 없다.
     - 11~12 worker 전면 병렬에서는 시간 초과가 났지만 단독 재실행에서는 재현되지 않았다(testing.md 3.5 포화 양상).
   - 실화면(1440·1024·881·390): 시작 전 168px와 진행 중 202px는 bust 크롭, 112·88·62px는 face 크롭이다. v3 박스는 스테이지 원과 일치하고, 기존 SVG는 남지 않는다.
-  - 반영: master `613bcb60`. 공개 웹 반영 명령은 자동 권한 판정이 막아 소유자 실행을 기다린다.
+  - 반영: master `613bcb60`. 공개 웹(Pages `vignette`, 미리보기 `https://dd96c2d5.vignette-b1q.pages.dev`)은 소유자가 직접 실행했다. 오케스트레이터의 반영 명령은 자동 권한 판정이 막았다.
+  - 운영 확인
+    - `https://vignette.chanpaca.net` 주 묶음이 이 빌드(`index-DdcluDZF.js`)와 같고, `ClientAvatar`·`p1Rig` 묶음에 v3 코드가 있다.
+    - `/avatar/v3/p1/*.webp`는 200(image/webp)이고, 이전 세대 묶음도 보존돼 200이다.
+    - 운영 로그인 화면에서 소유자가 시각 확인하는 일이 남았다.
 
 ### 2단계-B-1c P1 모티프 스프라이트 — 봉오리 1차 반려, 재배치 수용 (2026-09-30)
 

docs/dev_dashboard.html

@@ -1043,7 +1043,7 @@
                 <div class="task-row"><div><span class="task-status s-plan">GATE</span></div><div><b>한신대 공문/데이터 거버넌스 게이트 정리</b><p>SSO 클레임, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침을 P1 진입 전 외부 의존성으로 명확히 둔다. 로컬 문서 골격은 준비됐지만 한신대/데이터 steward의 written evidence는 아직 필요하다.</p></div><div><b>산출물</b><p><code>docs/ops/hanshin-data-governance-gate.md</code>, 공문 질의 항목, 동의 범위 체크리스트, SSO claim mapping 표</p></div><div><b>검증</b><p>문서 artifact 작성 완료; IRB 게이트가 아니라 데이터/SSO 게이트로 외부 증거 필요 상태 유지</p></div></div>
                 <div class="task-row"><div><span class="task-status s-doing">JEV-001</span></div><div><b>Jev 감정 판단 실증과 기존 내담자 경로 반복 비교</b><p>수용: 신규 artifact 보존 갱신, API legacy baseline 1191 passed/1 skipped/0 failed, engine 82 passed, web typecheck/build/API types 통과, NAS API 배포·공개 JS/CORS preflight, 인증 브라우저 3왕복·6발화와 DB 9축 감정 영속화. 보류: 성능 우위·정확도·품질 승격과 사용자 체감 지연 개선.</p></div><div><b>산출물</b><p>runner/probe·배포 artifact는 <a href="./decisions/jev-client-affect.md">Jev 결정문</a>과 <a href="./ops/evidence/jev-production-deploy-2026-09-22.json">운영 증거</a>에서 관리한다.</p></div><div><b>검증</b><p>새로고침 뒤 6발화 복원, 종료 review의 실제 6발화 요약·deep-loop 완료와 DB 종료 상태를 확인했다. USER-LATENCY는 text display·voice onset·완료 준비의 실제 경로 분리 측정과 안전 검사 유지 최적화가 남는다. 일시 502 관측 때문에 무중단을 주장하지 않는다.</p></div></div>
                 <div class="task-row"><div><span class="task-status s-doing">JEV-002</span></div><div><b>Jev 내담자 평가·표현 v2와 속마음 공개</b><p>수용: P0 가드레일 수단어 오탐("고독"·"다른 방법은") 제거, P1 20문항 질문 세트·반응/기분 분리·생성 지시 v2(1차 반려: noul 응답 필드), P2 migration 24·같은 트랜잭션 저장·세 경로 노출·리뷰(1차 반려: 교수자 cohort 누락·readiness 미등록), P3a 회기·리뷰 속마음 UI(2차 반려: 모바일 스위치 깨짐·컨트롤 바 높이 회귀), P3b 관리자 v2 표시. 보류: 실제 생성 대사 관측, 한국어 판정 정확도·전문가 보정, 운영 배포.</p></div><div><b>산출물</b><p><a href="./decisions/jev-client-affect-v2.md">v2 프로토콜</a>, <code>infra/db/init/24_client_inner_reaction.sql</code>, <code>scratch/jev/v2-appraisal-live.json</code>, <code>scratch/jev/inner-reaction-verify/</code></p></div><div><b>검증</b><p>HEAD <code>bda7ebb9</code> 대조로 full-sweep-session :644·:878·:974와 layout-visual-gate :970을 사전 실패로 분리했다. 보정 관찰: 공감 반영을 <code>a_understood</code>가 "비껴갔다"로 판정한 1건, <code>a_sore_spot</code> 고확률 선택 2/3건.</p></div></div>
-                <div class="task-row"><div><span class="task-status s-doing">AVATAR-V3</span></div><div><b>가상 내담자 아바타 v3 — 표현 엔진·반응 모션·리노컷 리그</b><p>소유자 결정(2026-09-30): 렌더는 벡터 리그 고도화를 혼합으로 구체화(덩어리는 판화 질감 이미지 레이어, 표정 부위는 코드 벡터), 강도 비례 하이브리드, P1 서연 파일럿, 아트는 리노컷 판화 + 작은 모티프·배경 색 변화. 수용: 0단계 아트 디렉션(1차 브리프 미충족 → 2차 수용), 트레이싱·참조 편집 spike, 1단계 엔진 코어(채널 33·표정 28·반응 클립 26·지문 파서·보조 cue)와 <code>/dev/avatar-lab</code>, 2단계-A P1 리노컷 레이어(1차 반려 → 분할 마스크 재작업 수용, 정지 합성 평균 절대차 1.22). 2단계-B-1b 렌더러는 기능 계약·E2E 수용, 모티프 스프라이트(2단계-B-1c) 수용. 진행: 2단계-B-1d 표정 판독성 개정 — 3차 캡처 판정에서 입(단색 렌즈 → 원화 입술 결 래스터 + 벡터 모양), 중립 눈썹 사선(원인: 눈썹 랜드마크가 잉크 띠 중심선이 아닌 모서리), 이마 주름 평행선, bust 200px 약한 표정 구분 불가를 반려하고 결정문 §8.4를 개정해 자산·렌더러 워커 병렬 재작업. 소유자 관찰(비탄 눈썹이 너무 위 → 프리셋을 AU1+AU4로, 말하는 입이 인위적 → 립싱크 재설계)에 따라 발화층 §5.4(한글 자모 비짐 9종 + TTS 오디오 선분석 정렬, <code>mouthRound</code> 채널, 페르소나 조음 폭)를 구현·검증(check:avatar-lipsync, avatar-lab E2E 16 passed)했고, 소유자 관찰(입술만 움직여 기괴함)로 발화 동반층 §5.5(억양·강세에 맞춘 고개 표류·끄덕임·들숨·눈썹 박·시선 회피·깜빡임)와 하관 띠 변형(턱·코 들썩, 볼 불룩, §8.4)을 구현했다. 입은 원화 픽셀 입술 스프라이트(24띠 변형, 중립 = 원화)로 바꿨고, 턱 두 줄 결함(투명 음영 비침·정적 clip·head 원본·hairFront 자산 오분류 턱선)과 볼 가장자리 틈을 규명·수정해 2단계-B-1d를 수용했다(out11 직접 확인, avatar-lab E2E 19 passed, 발화 중 rAF p95 6.2ms·long task 0). 소유자가 Lab에서 확인(2026-10-01 "괜찮네")하고 작업 브랜치 <code>YunChan/avatar-v3-linocut-p1-20261001</code>를 forgejo에 푸시했다(master 미병합·미배포). 운영 배포는 세션 연결(2단계-B-2) 뒤에 함께 한다(소유자 결정). 진행: P2~P7 리노컷 캐스트(외형·상징 설계 <code>docs/avatar-art/linocut-cast.md</code>, 원화 후보 v2 생성·소유자 선택 대기, 자산 파이프라인 공통화 <code>docs/avatar-art/linocut-pipeline/</code> — P1 재실행 바이트 동일), 2단계-B-2 세션 연결 수용(결정문 §8.5·§11: P1 세션·시작 전·썸네일 v3, 오디오 시계 립싱크, TTS 실패 시 텍스트 타이밍, <code>VITE_AVATAR_V3</code> 플래그. 세션 레이아웃·발화·표정 E2E 11 passed, avatar-lab 19 passed) · master <code>613bcb60</code> 반영, 공개 웹(Pages) 반영은 소유자 실행 대기. 남음: 공개 웹 반영·소유자 시각 확인, 3단계 API <code>avatar_cue</code>·지문 어휘 가이드, 4단계 7명 외형 SSOT. 운영 모델은 괄호 지문을 거의 쓰지 않는다(6턴 0개).</p></div><div><b>산출물</b><p><a href="./decisions/avatar-expression-engine-v3.md">아바타 v3 결정문</a>, <code>apps/web/src/components/avatar/engine/</code>, <code>docs/avatar-art/art-direction-v3/</code>, <code>docs/avatar-art/p1-linocut/</code></p></div><div><b>검증</b><p><code>npm run check:avatar-presets</code> 통과(표정 378쌍 구분, 최소 L1 0.95), <code>e2e/avatar-lab.spec.ts</code> 6 passed(오케스트레이터 재실행), typecheck·build·check:dead-code 통과(워커 보고)</p></div></div>
+                <div class="task-row"><div><span class="task-status s-doing">AVATAR-V3</span></div><div><b>가상 내담자 아바타 v3 — 표현 엔진·반응 모션·리노컷 리그</b><p>소유자 결정(2026-09-30): 렌더는 벡터 리그 고도화를 혼합으로 구체화(덩어리는 판화 질감 이미지 레이어, 표정 부위는 코드 벡터), 강도 비례 하이브리드, P1 서연 파일럿, 아트는 리노컷 판화 + 작은 모티프·배경 색 변화. 수용: 0단계 아트 디렉션(1차 브리프 미충족 → 2차 수용), 트레이싱·참조 편집 spike, 1단계 엔진 코어(채널 33·표정 28·반응 클립 26·지문 파서·보조 cue)와 <code>/dev/avatar-lab</code>, 2단계-A P1 리노컷 레이어(1차 반려 → 분할 마스크 재작업 수용, 정지 합성 평균 절대차 1.22). 2단계-B-1b 렌더러는 기능 계약·E2E 수용, 모티프 스프라이트(2단계-B-1c) 수용. 진행: 2단계-B-1d 표정 판독성 개정 — 3차 캡처 판정에서 입(단색 렌즈 → 원화 입술 결 래스터 + 벡터 모양), 중립 눈썹 사선(원인: 눈썹 랜드마크가 잉크 띠 중심선이 아닌 모서리), 이마 주름 평행선, bust 200px 약한 표정 구분 불가를 반려하고 결정문 §8.4를 개정해 자산·렌더러 워커 병렬 재작업. 소유자 관찰(비탄 눈썹이 너무 위 → 프리셋을 AU1+AU4로, 말하는 입이 인위적 → 립싱크 재설계)에 따라 발화층 §5.4(한글 자모 비짐 9종 + TTS 오디오 선분석 정렬, <code>mouthRound</code> 채널, 페르소나 조음 폭)를 구현·검증(check:avatar-lipsync, avatar-lab E2E 16 passed)했고, 소유자 관찰(입술만 움직여 기괴함)로 발화 동반층 §5.5(억양·강세에 맞춘 고개 표류·끄덕임·들숨·눈썹 박·시선 회피·깜빡임)와 하관 띠 변형(턱·코 들썩, 볼 불룩, §8.4)을 구현했다. 입은 원화 픽셀 입술 스프라이트(24띠 변형, 중립 = 원화)로 바꿨고, 턱 두 줄 결함(투명 음영 비침·정적 clip·head 원본·hairFront 자산 오분류 턱선)과 볼 가장자리 틈을 규명·수정해 2단계-B-1d를 수용했다(out11 직접 확인, avatar-lab E2E 19 passed, 발화 중 rAF p95 6.2ms·long task 0). 소유자가 Lab에서 확인(2026-10-01 "괜찮네")하고 작업 브랜치 <code>YunChan/avatar-v3-linocut-p1-20261001</code>를 forgejo에 푸시했다(master 미병합·미배포). 운영 배포는 세션 연결(2단계-B-2) 뒤에 함께 한다(소유자 결정). 진행: P2~P7 리노컷 캐스트(외형·상징 설계 <code>docs/avatar-art/linocut-cast.md</code>, 원화 후보 v2 생성·소유자 선택 대기, 자산 파이프라인 공통화 <code>docs/avatar-art/linocut-pipeline/</code> — P1 재실행 바이트 동일), 2단계-B-2 세션 연결 수용(결정문 §8.5·§11: P1 세션·시작 전·썸네일 v3, 오디오 시계 립싱크, TTS 실패 시 텍스트 타이밍, <code>VITE_AVATAR_V3</code> 플래그. 세션 레이아웃·발화·표정 E2E 11 passed, avatar-lab 19 passed) · master <code>613bcb60</code>·공개 웹(Pages <code>dd96c2d5</code>) 반영 완료(2026-10-01, 운영 묶음·P1 자산 200 확인). 남음: 운영 화면 소유자 시각 확인, 3단계 API <code>avatar_cue</code>·지문 어휘 가이드, 4단계 7명 외형 SSOT. 운영 모델은 괄호 지문을 거의 쓰지 않는다(6턴 0개).</p></div><div><b>산출물</b><p><a href="./decisions/avatar-expression-engine-v3.md">아바타 v3 결정문</a>, <code>apps/web/src/components/avatar/engine/</code>, <code>docs/avatar-art/art-direction-v3/</code>, <code>docs/avatar-art/p1-linocut/</code></p></div><div><b>검증</b><p><code>npm run check:avatar-presets</code> 통과(표정 378쌍 구분, 최소 L1 0.95), <code>e2e/avatar-lab.spec.ts</code> 6 passed(오케스트레이터 재실행), typecheck·build·check:dead-code 통과(워커 보고)</p></div></div>
                 <div class="task-row"><div><span class="task-status s-doing">ADMIN-OPENROUTER-001</span></div><div><b>관리자 OpenRouter 복구의 웹 검증과 새 OAuth 재시도</b><p>수용: <code>AmbiguousColumnError</code>의 기존 refresh column 참조와 <code>EXCLUDED.extra</code>의 text 캐스트 제거(JSONB 비교)를 수정했고, 실제 PostgreSQL rollback·API 교체·보존 census를 확인했다. 웹 focused 선택 16개와 정적 검증, NAS web·Pages 배포, public entry/health 200과 관리자 UI의 ready·복구 화면 없음은 수용했다. 진행 중: 새 사용자 OAuth finish 성공 관측.</p></div><div><b>산출물</b><p><a href="./ops/evidence/admin-openrouter-recovery-2026-09-22.json">운영 영수증</a></p></div><div><b>검증</b><p>API 1173 passed·1 skipped·0 failed, focused 16 passed, health <code>ok</code>·DB/engine true. API 교체 직후 census에서 133개 테이블 중 130개 동일이며 활동 메타데이터 3개는 변했다. OpenRouter UI 미연결과 Jev <code>live_verified=false</code>는 live 검증이 아니며, OAuth finish 성공은 아직 주장하지 않는다.</p></div></div>
                 <div class="task-row"><div><span class="task-status s-done">DONE</span></div><div><b>ADMIN-AFFECT-001 관리자 감정 관측 trace·그래프 운영 수용</b><p>수용: 완료 내담자 턴 trace의 공개 payload 비노출, API, 격리 PostgreSQL RLS·cascade, 성공·rollback 원자성, canonical artifact 기술 6/6, migration 23 운영 적용(RLS 2개 정책·grants·기존 행 0), API legacy baseline 1191 passed/1 skipped/0 failed와 gateway 82 passed, API 운영 health와 Pages 공개 index/AdminAffect JS/CSS·기존 사용자 bundle 200, 인증 CUA의 trace 1개·9축·5단계 분포와 새로고침 복원, NAS web build·컨테이너 교체 exit 0 및 API·engine·DB 컨테이너 유지.</p></div><div><b>산출물</b><p><a href="./decisions/jev-client-affect.md">Jev 결정문</a>, <a href="./ops/evidence/admin-affect-runtime-2026-09-23.json">운영 영수증</a>, <code>/admin/emotions</code>, <code>/admin/affect/sessions</code></p></div><div><b>검증 경계</b><p>web generate/check API types, typecheck, build, design SSOT와 focused 16개를 통과했고 dark/mobile/추이/관계 캡처 및 실제 리뷰 평가도 수용했다. 실제 1턴 관계 표시는 데이터 부족이며 fixture의 5개 이상 관계 계산 검증과 구분한다. watchdog은 한 차례 반려 뒤 root marker 보완으로 고정 수용했다. 전체 layout-visual-gate는 15개 중 1 passed·1 failed·13 not run이므로 전체 GREEN을 주장하지 않는다.</p></div></div>
                 <div class="task-row"><div><span class="tag info">B1-LAYOUT-720-001</span></div><div><b>720px prestart 시작 버튼 ancestor clipping</b><p>prestart <code>회기 시작</code>의 clip(<code>left=25</code>, <code>right=695</code>)이 baseline <code>d22cd988</code>과 현재 작업트리에서 동일하다. 감정 관측 기능 원인으로 단정하지 않고 cosmetic backlog로 추적한다.</p></div><div><b>다음 행동</b><p>원인을 분리한 뒤 focused browser 재현·수정 검증을 수행한다.</p></div><div><b>검증 경계</b><p>현재 전체 layout-visual-gate는 15개 중 1 passed·1 failed·13 not run이다. 관리자 3개와 session-layout desktop/mobile 각 4개 통과가 전체 gate 통과를 대체하지 않는다.</p></div></div>