Vignette 커맨드센터팀장 리뷰 · dev status
내 차례 0 2026-08-10 KST
project pulse

지금 위치: G0~G6 · G8 DONE. G7 external proof를 닫는 중.

현재: G8·공개 앱·주기 실회기 전체 GREEN. 다음: G7 명시 동의 mic·human pack·checker exit 0.

운영 복구·watchdog·배포 상세 보기

G8 clean-head NAS-origin은 candidate 112/112·실제 origin 112/112로 DONE이다. 공개 API는 detached-clean a73bcd24…·tree b02b3a1b…에서 OpenAPI 126, /admin/voice-runtime, local_whisper/small + melotts/melotts-korean, WS queue 4를 제공하며 fresh provenance receipt 47388d58…9b08가 passed다. 공개 Web은 Pages entry index-BrpoQ5nP.js와 review chunk SessionReview-E03q-dGb.js에서 literal [NAME] 0·시간 만료·모바일 44px/자동 스크롤 보정을 노출한다. 주기 실회기 7차는 clean aa81af29…에서 same-learner SSE→review→G4/G5 0→1→1과 별도 zero-state returned desktop/mobile 4/4, route mock 0, exact cleanup 0을 모두 통과했다. hourly heartbeat는 최신 GREEN이 6시간 이상 오래됐거나 학생 runtime·회기 폐루프 material milestone이 바뀔 때만 full runner를 최대 1회 실행한다. G7 human intake·checker·template-only 변경은 G7 focused gate만 실행해 학생 실DB runner와 증거를 섞지 않는다. 마이크를 열지 않은 G7 rehearsal은 인증 WSS·runtime·Windows topology 세 leg 7-sample로 통과했다. 다음 외부 gate는 실제 mic·동시 high-water·human evidence다.

2026-08-07 공개 DB는 recovered named volume으로 전환했고 원본 container·dump·volume을 보존했다. 2026-08-12에는 휴면 Gradle daemon의 8001 점유·cloudflared/voice sidecar 중단과 PowerShell 5.1 native stderr 조기 종료 결함을 복구했다. DB mutation 전에 fresh custom dump 9cbda31e…0ce5(7,532,625 bytes·TOC 1,492)를 고정했다. 공개 API·cloudflared는 detached-clean a73bcd24…·tree b02b3a1b…로 fresh 교체했고 public health 3/3·db/engine true·OpenAPI 126·local voice exact를 통과했다. 로그온·5분 watchdog 두 task도 같은 root/commit/tree/script SHA에 pin해 명시 실행 결과 0을 확인했다. 공개 runtime receipt는 47388d58…9b08, 무마이크 rehearsal evidence는 voice 61af2e98…·runtime c6e8670e…·topology 89f1cb86…이며 UUID/email literal 0이다. G7은 배포가 아니라 실제 mic·동시 high-water·human evidence만 남은 external GATE다.

G8 candidate/NAS-origin E2E 112/112 · 112/112 현재 전체 회귀 · gateway 58 · backend 921 Outcome clean E2E 126 · visual 15/15 Alliance G1 baseline 1.2 9/9 · 내부 DONE Tailnet 이전 확인 OK Public API 126 paths · G1~G8 Direct-runtime preflight APP ROLE OK critical 3 1차 완료·gate Decision P0 조건부

당신 차례 — 이걸 풀어주면 진행이 열린다

람다가 단독으로 못 정하거나(월권), 실제 계정·하드웨어·외부 합의가 필요한 항목. 각 카드는 무엇을 막는지 · 무엇이 필요한지 · 왜 당신인지를 담았다. 팀장이 우선순위를 골라 하나씩 풀어주면 된다.

🚧 GO를 막는 블로커 0
블로커Phase 0 마감 · P1 진입

공개 Google OAuth 실제 /turn 증명

필요: 로그인 가능한 계정으로 storageState 캡처 → public-auth-turn E2E 1회 통과.

왜 당신인가: 실제 Google 계정 인터랙티브 로그인이라 자동화 불가. (owner 지시로 현재 보류 상태)

증거: public-auth.json + public /turn 성공 로그
게이트Phase 3 파일럿 · 데이터

한신대 데이터/SSO 거버넌스

필요: SSO claim 스키마, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침에 대한 한신대/데이터 steward의 written evidence.

왜 당신인가: 기관 공문·협의 영역. 로컬 문서 골격은 준비됨(hanshin-data-governance-gate.md).

🧭 소유자 결정 (DECIDE) 0
결정됨아키텍처·일정

백엔드 언어 방향

소유자 결정: 장기 교체 대상과 신규 분리 서비스는 Node.js 우선. 단, 현재 FastAPI 전면 재작성은 일정 리스크라 계약 우선 strangler 방식으로 간다.

영향: 팀 역량은 Node로 맞추되, 납품 핵심 경로는 기존 Python 동작을 보존하며 교체 가능한 경계부터 만든다.

결정됨Phase 3 측정

평가설계 (H1: 실험/통제군·3척도·κ/ICC)

소유자 결정(2026-06-30): 평가자 신뢰도 목표 κ≥0.70 & ICC≥0.75, 환각률 ≤3%, 통계검정은 독립표본 t-검정(α=0.05), 20명을 실험/통제군으로 무작위 배정, 단회기 50분·3척도 pre-post는 doc4대로 유지. 설계 파라미터는 확정됐고, 실제 20명 파일럿 evidence·통계해석은 별도 GATE로 남는다.

영향: 평가 타당도, Phase 3 측정력. 설계는 확정, 효과성 판정은 파일럿 데이터 이후.

결정됨음성 아키텍처

s2s 2차 PoC 채택 여부

소유자 결정(2026-06-30): 캐스케이드 1차를 유지하면서 s2s 2차 PoC를 계속 연다. voice-s2s-poc.md 기준표(transcript·safety·audit·latency·failure·privacy)로 비교 리포트를 만든 뒤 최종 채택/폐기를 다시 판단한다.

방향: s2s 2차 PoC 유지 → 비교 PoC 구현·실측이 후속

결정됨페르소나 음성

서비스용 음성 모델·권리 정책

소유자 결정(2026-06-30): 서비스 배포 음성은 상업 라이선스가 명확한 대체 TTS provider로 간다. Higgs 무참조 synthetic 샘플과 dev-only sample provider는 개발 플래그로만 유지하고, 실존 인물/성우 ref 사용 금지를 유지한다.

방향: 대체 TTS provider 채택 → provider 선정·통합이 후속

결정됨데이터주권·레이턴시

fast-loop 외부 API 허용 여부

소유자 결정(2026-06-30): 로컬 상주 분류기를 기본으로 하되 외부 Haiku/Solar 폴백을 허용한다. 외부 전송 시 데이터주권·로그 보존 정책과 동의 범위를 함께 적용한다.

방향: 외부 폴백 허용 → 폴백 경로·전송 가드 구현이 후속

결정됨운영 감사·장애 대응

운영 보존기간·에스컬레이션 정책

소유자 결정(2026-06-30): 헬스 raw 이벤트 90일, 일별 rollup 365일 보존. 우선순위 escalation은 운영자 수동 승인, SLA는 미표기(현 값은 관측 샘플 이력으로 유지), 담당 그룹 자동 배정은 도입하지 않는다.

방향: raw 90일/rollup 365일 · 수동 escalation · SLA 미표기 → retention 기본값 적용이 후속

결정됨동의서·데이터셋

재귀학습 fine-tuning 범위

소유자 결정(2026-06-30): few-shot 자동갱신에 더해 fine-tuning까지 범위에 포함한다. 단 실제 fine-tuning 데이터셋은 동의 범위·축어록 수급 결정이 닫힌 뒤에 구성한다.

방향: fine-tuning 포함 → 동의/데이터셋 게이트 충족 후 파이프라인 구축

결정됨안전 정책

자유연습 기본값

결정: 기본 ON + 피드백 권장 배지 + 교수자 토글. 미동의·미성년 개인정보 gate만 차단한다.

근거: MASTERPLAN_REVISIONS F-10 승인

결정됨평가 타당도·다양성

추가 축어록 수급 규모/일정

소유자 결정(2026-06-30): 추가 사례 20건을 1개월 내 수급한다. n=1 시드 한계를 해소하고 페르소나 다양성·Phase 3 측정력을 확보하기 위한 목표다.

영향: 평가 타당도, 페르소나 다양성, Phase 3 측정력. 실제 수급·동의·정제는 임상/거버넌스 게이트와 연계.

🤝 외부·임상팀 조율 0
조율위기게이트·평가·이론

임상팀 콘텐츠 (구훈정·어유경)

필요: C1 루브릭 항목·척도·가중치·anchor 예시·컷오프·검수 기준의 임상팀 확정본, CBT 이론별 단계 프롬프트 체인, 위기 스크립트·생명유지서약 문안, H2 평가 골든셋. 코드는 C1 schema/loader/validation scaffold까지만 준비됨.

왜 당신인가: doc3 R&R상 콘텐츠는 임상팀 산출물. 코드는 '편집 가능 구조'만 선제 구축 → 조율·수급 필요.

거버넌스계약·일정

스택 정합성·저작권 등재 (L1)

방향은 Node.js 교체 가능성 우선으로 정했다. 남은 일은 FastAPI 유지 사유, 계약 우선 전환 계획, 저작권 등재 문서 반영을 거버넌스 증거로 남기는 것이다.

권고: docs/decisions/backend-node-transition.md 기준으로 신청서/등재 문서의 스택 설명을 정합화한다.

진행 현황

아래 "상태 보드"의 작업 카드에서 자동 집계. 완료/진행/계획 비율과 트랙별 완료도. (Phase 진행률은 단계별 증거 기반 추정치 — 정밀 수치 아님)

상태 분포

추적 작업 0건 기준

완료 0 진행 0 계획 카드 0

트랙별 완료도

카테고리별 완료 카드 / 전체 카드

관계도 — 무엇이 무엇을 막는가

왼쪽 내 차례(clay) 노드를 풀면 가운데 게이트/작업이 열리고, 오른쪽 납품·마일스톤으로 이어진다. 화살표를 따라가면 "내가 지금 풀어야 임계경로가 뚫리는 것"이 보인다.

내 차례 (OWNER) 게이트 · 작업 납품 · 마일스톤 OAuth /turn 증명 백엔드 언어 결정 임상팀 콘텐츠 평가설계 (H1) 한신대 거버넌스 Phase 0 마감 Phase 1 MVP 위기게이트 1091차 구현 · 검증 교수자 성장 UI1차 구현 · 검증 평가 KPI (H1) Phase 1 GO 납품 필수조건법적 생존선 Phase 3 파일럿
내 차례 — 윤찬이 풀어야 열림 납품 필수 — 미구현 임계작업 게이트·마일스톤 ··· 점선 = 약한/아키텍처 의존

디자인 시안 지침 — 기능 추출 기반 이미지 생성

2026-06-27 기준 주요 페이지 기능을 추출해 PC·태블릿·모바일 반응형 시안 7장과 온화한 이미지 요소 보드 2장을 만들었다. 결과물은 전부 PNG 래스터 이미지이며, 구현 확정안이 아니라 레이아웃·톤·이미지 요소 판단 기준이다.

프롬프트 문서

적용 원칙: 생성 이미지 안의 문구는 참고하지 말고 실제 카피는 코드/기획서 기준으로 다시 쓴다. 세션 아바타는 모든 페르소나에서 기존 SVG 도형 기반 파라미터 리그만 사용하며, 생성 이미지/PSD 래스터 파츠는 보존하되 제품에 연결하지 않는다. 교수·관리자 내비게이션은 현재 AppShell·Sidebar 구조를 유지하고, 배경 일러스트·패턴은 빈 상태·히어로·세션 주변 질감에 소량만 쓴다.

1차 적용(2026-06-27): 온화한 이미지 요소 보드는 구현 참고용으로만 두고, 앱 배경에는 전용 래스터 텍스처 `apps/web/public/design-elements/clinical-paper-ambient.png`를 연결했다. 보드·타일셋·누끼 시트 형태 이미지는 직접 UI 배경으로 쓰지 않는다.

2차 적용(2026-06-27): 생성된 관리자/설정/리뷰 시안 기준으로 admin 역할의 상단바·사이드바를 어두운 운영 콘솔 크롬으로 전환했고, 관리자 사용자 관리 행을 조밀한 운영 테이블 밀도로 낮췄다. 회기 리뷰는 헤더·인사이트 카드·피드백 스테이지에 따뜻한 래스터 질감과 낮은 채도 틴트를 적용했다.

3차 적용(2026-06-27): 상담 세션 시작/진행 화면을 시안 기준의 어두운 상담 스테이지로 재정렬했다. 시작 전 화면은 내담자 무대·브리핑·진행 초점 3영역으로 유지하고, 진행 중 화면은 어두운 캔버스 위에 중앙 스테이지와 자막/컨트롤을 배치한다.

4차 적용(2026-06-27): 교수 콘솔은 시안의 triage 콘솔 구조에 맞춰 KPI를 전폭 6칸으로 재배치하고, 종료 회기 검토 큐와 최근 회기 기록을 첫 화면 2열 핵심 영역으로 올렸다. 학생별 장기 추이와 전체 회기 타임라인은 별도 학생 분석 메뉴로 분리하고, 교수자 사이드바는 좁은 teal rail로 전환했다.

5차 적용(2026-06-27): 회기 리뷰는 시안의 좌·중·우 작업대 구조에 맞춰 요약/액션 레일, 감정·흐름 중앙 영역, 우측 인사이트 패널로 재배치했다. 모바일에서는 트랜스크립트를 워크시트보다 먼저 노출하고, 사례개념화 워크시트는 제한 높이의 보조 패널로 낮춰 긴 문서처럼 보이지 않게 했다.

6차 적용(2026-06-27): 설정 화면은 글로벌 셸을 숨기고 설정 전용 좌측 레일을 주 내비로 승격했다. 계정, AI 운영, 테마, 음성, 알림 카드를 시안의 차분한 설정 워크스페이스 흐름에 맞춰 단일 컬럼으로 재배치했고, 모바일은 상단 고정 섹션 탭으로 모든 항목이 잘리지 않게 정리했다.

7차 적용(2026-06-27): 로그인 화면은 별도 생성한 래스터 상담실 배경(login-counseling-room.png)을 왼쪽 브랜드 패널에 적용해 시안의 실제 상담실 분위기를 반영했다. 학습자 홈은 모바일 grid 행 계산 때문에 생기던 리스트-상세 간 큰 공백을 제거하고, 회기 준비 보드가 한 흐름으로 이어지게 정리했다.

8차 적용(2026-06-27): 다크 테마가 라이트 primitive 토큰과 역할 accent에 덮여 흰 섹션이 섞이던 문제를 수정했다. 앱 부트 시 테마를 먼저 적용하고, 다크 모드에서 paper/surface/hair/ink primitive까지 스왑한다. 상담 세션 진행 화면은 테마 토글과 무관하게 어두운 콘솔 패널로 고정했고, 드래그형 종료 제스처는 명시적 회기 종료 버튼 + 확인 다이얼로그로 교체했다. 회기 리뷰도 동일한 다크 카드/축어록/워크시트 재질로 보정했다.

9차 적용(2026-06-27): 관리자 콘솔 IA를 /admin 운영 홈과 /admin/users 사용자 관리, /admin/access 접근 권한, /admin/tickets 운영 티켓 메뉴로 분리했다. 운영 홈은 실제 API가 있는 교육 진행·온라인 사용자·헬스·AI 비용·서비스 리소스를 우선 표시하고, 티켓/업타임 이력은 app.support_ticket·app.admin_health_event 기반 저장 모델로 연결했다. 세분 그룹 권한 enforcement는 아직 정책 화면이며 가짜 권한 효과를 표시하지 않는다.

17차 적용(2026-06-28): 운영 홈의 티켓 요약은 resolved/closed 이력을 진행 중 위험으로 세지 않는다. high_priority_count와 미니 티켓 목록은 미해결 티켓 기준이며, E2E 운영 티켓 테스트는 제목·본문에 테스트임을 명시하고 실패 시에도 cleanup patch로 해결 처리한다.

19차 적용(2026-06-28): /admin/tickets는 현재 범위를 미해결 큐 목록과 상태 변경으로 좁혔다. 정적 분류/인사이트 탭은 제거하고, 카드에 카테고리·신고자·경로·접수/갱신 시각을 표시한다. 해결된 항목은 최근 해결 이력으로 내려간다. 필터·카테고리 큐는 이후 26차에서 처리했고, Claude Recipe headless 자동 처리·이슈 등록은 백로그 운영 티켓 자동 분류·처리 2차로 남겼다.

26차 적용(2026-06-28): /admin/tickets에 검색, 상태·카테고리·우선순위·담당그룹·정체 필터와 카테고리 quick queue를 추가했다. 서버는 동일 query를 DB에서 처리하고, 티켓 접수 및 관리자 수동 처리 변경은 audit.audit_log에 metadata-only로 남긴다. Claude Recipe 자동 수정 후보, 이슈/PR/작업 스레드 생성은 운영자 승인 전까지 계속 후속으로 둔다.

28차 적용(2026-06-28): 학습자 Settings에 지원 요청 섹션을 추가했다. GET /users/support-tickets는 현재 사용자 reporter_id의 티켓만 최신순으로 반환하고, 본문·신고자 이메일·신고자 이름은 응답에서 제외한다. Settings는 상태·카테고리·우선순위·담당 그룹·해결 메모만 읽기 전용으로 보여주며, 조회 실패는 설정 전체 로딩을 막지 않는다.

29차 적용(2026-06-28): /admin/health와 synthetic sampler가 같은 record_admin_health_sample() 경로를 사용한다. scripts/record-admin-health-sample.py는 브라우저 admin 세션 없이 app.admin_health_event에 서비스별 샘플을 append하고, scripts/install-health-sampler-task.ps1는 Windows Scheduled Task로 주기 실행을 설치한다. 최신 로컬 one-shot은 recorded_count=5, status=ok, engine_mode=claude_cli다.

30차 적용(2026-06-28): 헬스 샘플 이력은 raw app.admin_health_event와 daily app.admin_health_daily_rollup으로 분리했다. scripts/maintain-admin-health-events.py--rollup-days/--retention-days 명시 인자를 요구하고 기본 dry-run으로 동작한다. apply 모드는 rollup upsert 후 retention window 밖 raw row만 삭제하며, non-dev apply는 추가 확인 플래그 없이는 막는다. /admin/uptime 요약은 raw+rollup을 중복 없이 합산하고 상세 이벤트 목록은 최근 raw 샘플만 보여준다.

31차 적용(2026-06-28): 운영 티켓 중복 처리는 자동 병합이 아니라 수동 연결 1차로 닫았다. 사용자 티켓 생성은 결정론적 fingerprint를 저장하고, /admin/tickets는 같은 fingerprint 후보 수·oldest parent 후보·하위 티켓 수를 반환한다. 관리자는 기존 PATCH /admin/tickets/{id}parent_ticket_id를 지정/해제하며, self-parent와 cycle은 서버가 거부한다. Settings의 사용자별 티켓 조회에는 fingerprint/parent를 노출하지 않는다.

27차 적용(2026-06-28): 백엔드 언어 방향은 Node.js 우선 교체 가능성으로 정리하되 FastAPI 전면 재작성은 보류했다. 첫 경계로 app/contracts/engine_gateway.py를 추가해 /v1/generate, /v1/stream, SSE token/done/error 계약을 FastAPI client와 현재 Python gateway가 함께 쓰게 했다. 결정 기록은 docs/decisions/backend-node-transition.md에 둔다.

32차 적용(2026-06-28): Engine gateway SSE parsing을 app/contracts/engine_gateway.pytoken/done/error wire contract로 이동했다. gateway token payload, done telemetry, error detail 검증은 공유 계약 decoder가 맡고, gateway error는 저장 턴을 만들지 않는 기존 경계를 유지한다. 34차에서 이 raw line 해석 소유권은 EngineClient.stream_packets() 경계로 올려 Node.js gateway 교체를 위한 계약 증거를 강화했다.

33차 적용(2026-06-28): H1 pre/post evidence 원장을 학습자 SessionReview 화면에 연결했다. 학습자는 자기효능감·기술숙련도·수련만족도 3척도의 사전/사후 1~5 aggregate score를 조회·저장할 수 있고, 화면 문구는 효과 판정·통계 검정이 평가설계 확정 이후 별도 산출임을 명시한다. 구현 중 React 이벤트 값을 상태 updater 안에서 늦게 참조해 앱이 검은 배경만 남는 크래시도 확인해 수정했다.

34차 적용(2026-06-28): Node.js gateway 교체 가능성을 위해 엔진 스트림 wire parsing 소유권을 EngineClient.stream_packets()로 올렸다. 앱 orchestrator는 raw SSE line이 아니라 EngineGatewaySsePacket만 처리하고, Python gateway의 /v1/generateGenerateResponse.model_dump()로 반환해 hand-mirrored dict drift를 줄였다. focused gateway/orchestrator/session 회귀는 46 passed.

35차 적용(2026-06-28): X2 비용 통제 후속으로 fast/deep evaluator structured 결과에 인메모리 semantic cache 1차를 추가했다. 캐시 키는 canonical evaluator request의 SHA-256이며 원문 prompt·completion은 저장하지 않는다. 성공 파싱 결과만 TTL/entry 제한 안에서 재사용하고, engine error·parse error는 캐시하지 않는다. focused evaluator/runtime/admin 회귀는 40 passed.

36차 적용(2026-06-28): H1 pre/post 원장에서 Phase 3 evidence root용 02-measures/prepost_measures.csv02-measures/kpi_report.json을 생성하는 1차 계산기를 추가했다. participant id는 P3-###로 가명화하고, 3척도 paired normalized mean pre/post/delta, complete/missing pair를 report에 채운다. 공식 효과성 판정·통계검정·실험/통제군 배정은 아직 평가설계 게이트다. focused H1/backend 회귀는 45 passed.

37차 적용(2026-06-28): H4 한국어 NAME/ORG 마스킹에 합성 fixture 기반 평가 harness를 추가했다. 초기 NAME/ORG baseline은 scripts/evaluate-pii-masking.py로 entity recall·forbidden substring removal·unexpected entity violation을 출력했고, fixture가 잡은 소속/안내 NAME 오탐은 stopword로 보정했다. 이 baseline은 62차에서 11-case schema-backed dry-run으로 확장했다.

38차 적용(2026-06-28): M2 다회기 케이스 아크 2차로 세션 종료 시 마스킹 축어록 기반 fallback session_summary.digestcase_profile.case_digest, rapport_trajectory, alliance_level을 갱신한다. 다음 회기 seed recall은 case_digest·직전 요약·client-visible pinned_fact를 함께 조립한다. 당시 후속이던 pinned_fact 자동 쓰기는 43차에서 보수적 identity/agreement 범위로 연결했다. focused M2 회귀는 43 passed.

39차 적용(2026-06-28): X2 evaluator semantic cache 운영 관측을 /admin/usage와 관리자 AI 비용 카드에 노출했다. 응답은 cache key나 prompt/completion 없이 enabled, entries, hits, misses, stores, evictions, requests, hit_rate만 반환한다. 당시 X2/backend focused 40 passed였고, 최신 X2 리포트 라운드는 42 backend passed + CLI sample OK다. API typecheck/build, admin E2E 1 passed.

40차 적용(2026-06-28): H3 페르소나 draft 생성 프롬프트에 persona-draft-rag@2026-06-28.1 bundle pinning을 추가했다. POST /personas/drafts/generate는 engine metadata와 draft source_provenance에 prompt bundle id/version/hash를 남겨 source/chunk 증거와 생성 프롬프트 버전을 함께 추적한다. focused persona review 회귀는 31 passed.

41차 적용(2026-06-28): X2 장기 비용 추이 1차로 /admin/usage에 일별 daily_cost bucket(day, turns, tokens_in/out, cost_usd)을 추가하고, 관리자 AI 비용 카드에 최근 일별 비용/턴 추이를 표시했다. DB와 dev runtime fallback 모두 같은 shape를 반환한다. 자동 차단·한도 enforcement는 운영 정책 결정이 필요해 후속으로 남긴다. backend 40 passed, API typecheck/build, admin E2E 1 passed.

42차 적용(2026-06-28): M1 비언어 이벤트 2차로 voice learner turn에 provider_events JSONB 보존 슬롯을 추가했다. WebSocket control/STT provider 이벤트는 allowlist·개수·문자열 길이 제한을 거쳐 app.turns.provider_events에 저장되고, raw transcript/text payload는 보존하지 않는다. 당시 기준으로 review/public API에는 아직 노출하지 않고 기존 nonverbal 칩은 audio/silence/pace/barge-in 파생만 유지했다. focused voice/session 회귀는 44 passed.

43차 적용(2026-06-28): M2 다회기 메모리 3차로 세션 종료 시 마스킹된 client-visible 발화에서 보수적 pinned_fact 후보를 자동 실적재한다. 1차 범위는 [NAME]/[ORG] identity와 명시적 상담 약속만이며, 관계갈등·위기·임상 추론은 pinning하지 않는다. learner-owned case_profile 기준 RLS insert/update 정책을 추가했고, 다음 회기 recall은 기존 client-visible pinned_fact 읽기 경로를 그대로 사용한다. focused M2 회귀는 60 passed.

44차 적용(2026-06-28): M2 다회기 메모리 4차로 pinned_fact 삽입 또는 값 변경 시 pinned_fact_history에 append-only 이력을 남긴다. 같은 값 재확인은 history를 늘리지 않고, locked fact는 계속 건드리지 않는다. 이유값은 최초 기록 progression, 값 변경 clarification로 제한했으며, 자동 모순 판정은 아직 후속이다. focused M2 회귀는 62 passed.

45차 적용(2026-06-28): M1 비언어 이벤트 3차로 저장되는 provider_events에 내부 taxonomy event_type/category를 붙인다. raw provider type/kind/label은 보존하되 sigh/cry/laugh/voice_activity/noise 등은 canonical key로 정규화한다. raw transcript/text payload는 계속 drop했고, 당시 기준으로 review/public API 노출은 하지 않았다. focused voice/session 회귀는 45 passed.

46차 적용(2026-06-28): C3 이론모드 2차로 세션 시작 전 화면에 humanistic/cbt/integrative 명시 선택 segmented control을 추가했다. 기본값은 기존처럼 페르소나 theory_target에서 잡고, 사용자가 바꾼 값은 POST /sessionstheory_mode로 전송된다. CBT 체인·임상 문안·이론부합 루브릭은 만들지 않았다. 검증: web typecheck/build, C3 backend focused 31 passed, session-layout desktop/mobile 8 passed, session-mvp 1 passed, layout visual gate 9 passed.

47차 적용(2026-06-28): H3 seed/version materializer runner 1차로 scripts/materialize-persona-seeds.py를 추가했다. 기본은 DB를 건드리지 않는 dry-run manifest 보고이고, --json은 P1~P7 seed_version/persona_id/source_provenance를 기계 판독 형태로 내보내며, --apply일 때만 DB pool을 초기화한 뒤 기존 idempotent materialize_seed_personas()를 호출한다. 당시 후속이던 source pack content_hash/document version 증분 sync runner는 48차에서, 원문 격리 정책 1차는 55차에서 처리했다. 검증: runner py_compile, py -3.11 scripts\materialize-persona-seeds.py --json dry-run manifest_count=7, focused persona review 33 passed.

48차 적용(2026-06-28): H3/H2 repo-managed source pack version sync runner 1차로 app.services.source_pack_syncscripts/sync-persona-sources.py를 추가했다. 기존 POST /kb/live-coach/source-packs/sync도 같은 service를 사용하며, active kb.documentcontent_hash가 같으면 skip하고 다르면 previous_version + 1로 색인해 UNIQUE(source_id, doc_uri, version) 충돌을 피한다. dry-run은 DB 상태를 읽되 write하지 않고, --apply에서만 kb.source upsert와 kb.document/kb.chunk 색인을 수행한다. 당시 남은 원문 격리 정책 1차는 55차에서 처리했고, 임상팀 최종 검수 evidence는 여전히 후속이다. 검증: source sync py_compile, py -3.11 scripts\sync-persona-sources.py --help, test_live_coach_sources.py 4 passed.

49차 적용(2026-06-28): M1 비언어 이벤트 4차로 인증된 회기 리뷰의 nonverbal 칩에 정규화된 provider taxonomy 일부를 제한 노출한다. sigh/cry/laugh/breath, prosody, background noise 같은 event_type은 한글 label/detail로 파생하고, provider/source/raw type/text/transcript는 응답에 싣지 않는다. 공개 공유 카드도 축어록과 provider raw를 계속 제외한다. 검증: M1 backend focused 45 passed, npm run check:api-types, npm run typecheck, npm run build, session-review.spec.ts 3 passed.

50차 적용(2026-06-28): M2 pinned fact 모순 처리 1차로 명시적 상담 약속 철회/부정만 agreement:counseling 기존 fact의 status='contradicted'로 격리한다. 새 contradicted fact를 임의 생성하지 않고, non-locked 기존 fact가 있을 때만 업데이트하며 history reason은 contradiction으로 남긴다. 관계갈등·위기·임상 추론과 값 다름 일반 케이스는 계속 자동 모순 처리하지 않는다. 당시 검증: test_session_memory.py 11 passed, M2 focused 64 passed.

51차 적용(2026-06-28): L1 Node.js 전환 계약 증거 2차로 apps/api/engine_gateway/golden/engine_gateway_contract.v1.json golden fixture와 engine_gateway_schema.v1.json schema artifact를 추가했다. fixture는 /v1/generate request/response, /v1/stream token/done/error frame과 decoded packet, provider [DONE] compatibility line을 고정한다. schema는 Node.js gateway가 Python import 없이 검증할 request/response/event shape를 고정한다. Python 계약 테스트가 schema drift와 fixture validation을 같이 보므로, 미래 Node.js gateway는 Python JSON whitespace가 아니라 같은 artifact의 의미론적 packet 동등성으로 conformance를 증명하면 된다. 당시 검증: gateway contract 18 passed, L1 focused 49 passed.

52차 적용(2026-06-28): L1 Node.js 전환 계약 증거 3차로 scripts/check-engine-gateway-contract.mjs conformance runner를 추가했다. 이 runner는 Python import 없이 golden fixture와 schema artifact를 읽고, generate request/response shape, stream token/done/error frame decoding, provider [DONE] compatibility line 무시를 검증한다. engine_gateway/test_gateway_model.py도 Node runner를 subprocess로 호출해 Python 계약 테스트와 Node 계약 검증이 같은 artifact를 공유하도록 했다. 검증: node scripts/check-engine-gateway-contract.mjs --json, gateway contract 19 passed, L1 focused 50 passed.

53차 적용(2026-06-28): M2 episodic embedding writer 1차로 세션 종료 저장 성공 뒤 _write_episodic_embeddings() background task를 예약한다. writer는 speaker='client', turn_id 있음, client visible, text_masked nonempty 조건만 통과시키고 원문 text, 상담자 발화, evaluator-only turn, 평가 payload는 색인하지 않는다. app.turn_embedding 쓰기는 BGE-M3 dense/sparse를 ON CONFLICT (turn_id) DO NOTHING으로 idempotent 저장하며, DB/pgvector/embedder 미구성은 종료 저장을 실패시키지 않는다. 검증: test_session_memory.py 14 passed, M2 focused 67 passed.

54차 적용(2026-06-28): X2 모델별 비용 리포트 1차로 app.services.usage_reportscripts/report-ai-usage.py를 추가했다. 기존 /admin/usage JSON을 입력으로 provider/model별 cost share, token share, cost/turn, cost/1k tokens, metered coverage, budget/cache warning을 산출하되 자동 차단이나 한도 enforcement 정책은 만들지 않는다. 검증: usage report 2 tests, X2 focused 42 passed, CLI sample report schema vignette.ai_usage_model_cost_report.v1 생성.

55차 적용(2026-06-28): H3 원문 격리본 정책 1차로 kb.raw_source_artifact hash-only 레코드를 추가하고, POST /personas/sources가 raw 원문 hash와 sanitized RAG source를 분리해 기록하게 했다. rag.index_document()sensitivity=3 또는 raw source marker 청크를 DB 접근 전에 IndexPolicyViolation으로 차단하므로 raw 원문은 kb.chunk/embedding/FTS로 들어가지 않는다. 암호화 blob/vault 저장은 후속. 검증: raw isolation py_compile, H3 focused 38 passed.

56차 적용(2026-06-28): H2 회기 리뷰 workbench 1차로 학습자 SessionReview 데스크톱 레이아웃을 축어록 타임라인과 요약·감정·흐름·루브릭·강점·개선점·pre/post·워크시트·피드백 작업영역으로 재배치했다. 교수자 검토 화면과 모바일/태블릿 반응형은 기존 규칙을 유지한다. 검증: web typecheck, session-review.spec.ts 3 passed, layout-visual-gate.spec.ts 9 passed, 1440 desktop screenshot 직접 확인.

57차 적용(2026-06-28): L1 Node.js 전환 준비 4차로 브라우저-facing 세션 read-model을 app/session_read_model.py로 분리했다. routes/sessions.py는 route/auth/RLS DB read/persistence를 유지하고, 세션 목록·대시보드·상세·리뷰·공유 payload DTO와 deterministic builder는 read-model 모듈이 소유한다. OpenAPI field shape와 hidden-turn/evaluator-only filtering, saved worksheet 우선순위, teacher review read-only 경계는 유지했다. 검증: session read-model py_compile, focused backend 48 passed, npm run check:api-types, npm run typecheck.

58차 적용(2026-06-28): 학습 세션 텍스트 턴은 학습자 발화 버블을 전송 즉시 표시하고, 내담자 응답 전에는 임시 대기 버블만 보여준다. 채팅 입력은 응답 생성 대기 중에만 막고, 음성 TTS 재생 중에는 자막이 먼저 남은 상태에서 텍스트 입력을 유지하며 음성 건너뛰기 버튼으로 재생을 중단할 수 있다. 검증: web typecheck, session-mvp.spec.ts 1 passed, voice-success.spec.ts synthetic UI 1 passed.

59차 적용(2026-06-28): L1 Node.js 전환 준비 5차로 브라우저-facing 페르소나 DTO와 deterministic mapper를 app/persona_read_model.py로 분리했다. routes/personas.py는 route/auth/teacher-admin gate/DB repository/RAG source 등록/LLM draft generation/error mapping을 유지한다. PersonaSummary, PersonaReviewSummary, PersonaDraftPayload, PersonaDraftDetail, source/evidence 응답 schema 이름과 source/degraded fail-closed catalog 경계는 유지했다. 검증: persona read-model py_compile, test_persona_review.py 33 passed, persona/session-start 55 passed, npm run check:api-types, npm run typecheck.

60차 적용(2026-06-28): H3 항목형 저작 UI 9차로 PersonaStudio의 자동사고, 회기 시나리오, 말투 목록, 역린·금기 목록을 줄바꿈 textarea에서 행 추가/삭제 UI로 바꿨다. 저장 payload는 기존 배열 schema를 유지하고, 빈 항목은 저장 직전에 제거한다. 검증: npm run typecheck, npm run build, teacher.spec.ts 7 passed, layout-visual-gate.spec.ts 9 passed, session-layout.spec.ts desktop/mobile 8 passed.

61차 적용(2026-06-28): H3 프롬프트 미리보기 10차로 PersonaStudio 프롬프트 탭의 raw JSON textarea를 제거하고, 같은 draft 데이터를 L1 카드·인적 범주·임상 배경·말투·수치 파라미터·역린·회기 시나리오·추가 계약 섹션으로 검토하게 했다. 런타임 prompt bundle, API 계약, 임상 문안은 바꾸지 않았다. 검증: npm run typecheck, npm run build, npm run check:api-types, teacher.spec.ts 8 passed, 프롬프트 탭 포함 layout-visual-gate.spec.ts 9 passed.

62차 적용(2026-06-28): H4 마스킹 평가 준비 3차로 합성 fixture를 5건에서 11건으로 확장하고, NAME/ORG 외 PHONE/EMAIL/RRN/NUMID/DATE/MONEY/ADDR/negative-control까지 source/category/severity metadata로 평가한다. pii-masking-eval-input.schema.jsonpii-masking-eval-report.schema.json을 추가했고, 기본 리포트는 masked_text 원문 증거를 빼는 summary-only technical_dry_run이다. 실제 운영 말뭉치 기반 평가는 아직 외부 데이터·reviewer label·법무/guardian evidence gate다. 콘솔의 /favicon.ico 404는 SVG favicon link 추가로 해소했다. 검증: H4 focused 42 passed, CLI fixture 11/11 pass, py_compile.

63차 적용(2026-06-28): C1 루브릭 외부화 3차로 data/rubrics/case-worksheet-rubric.json scaffold와 Draft 2020-12 schema, app.services.case_worksheet_rubric, scripts/check-case-worksheet-rubric.py를 추가했다. scaffold는 서버 생성 워크시트 5개 section/28개 item key와 맞는지만 검증하고 status=scaffold_only, scoring_enabled=false를 유지한다. 임상팀 확정 criteria/anchor/가중치/컷오프 없이는 AI 채점이나 점수 노출을 켜지 않는다. 검증: rubric focused 4 passed, CLI PASS with sha256 provenance, py_compile.

64차 적용(2026-06-28): refactor-governance 1차로 C1 생성 워크시트 section/item spec을 CASE_WORKSHEET_SECTION_SPECScase_worksheet_template_item_keys()로 올려 루브릭 validator/CLI/test가 더미 ReviewTurn 없이 같은 템플릿 키를 참조하게 했다. API/DB/frontend 응답 shape와 저장본 우선순위는 바꾸지 않았다. 검증: C1 focused 34 passed, rubric CLI PASS, py_compile, residual grep.

65차 적용(2026-06-28): refactor-governance 2차로 프론트 inline CSS template literal을 제거했다. Loginpages/login/LoginBrand.tsx, LoginPanel.tsx, login.css로 분리해 인증 상태 로직과 프레젠테이션을 나눴고, PendingApproval, Onboarding, LearnerHome, Professor, PersonaStudio, ClientAvatar*_CSS 상수는 인접 CSS 파일 import로 옮겼다. 검증: inline <style>{..._CSS}</style> residual 0건, npm run typecheck, npm run build, 로그인 Playwright 렌더 스모크.

66차 적용(2026-06-28): H4 자연 발화형 한국어 이름 마스킹 보강으로 제 이름은 김서연입니다, 보호자 이름은 박민수입니다, 저는 최하늘입니다 패턴과 이름은 중요하지 않다 negative control을 합성 fixture에 추가했다. 이름 stopword와 자기소개형 이름 패턴을 generic 성씨+조사 패턴보다 앞에 두어 라벨 단어만 마스킹하고 실명을 남기던 구멍을 막았다. 검증: H4 focused 43 passed, CLI fixture 15/15 pass, py_compile.

67차 적용(2026-06-28): M2 다음 회기 회상 주입 증거를 route-level로 고정했다. REST submit과 SSE stream이 공통 _prepare_turn_context() 경계에서 seed recall, pinned fact, 최근 client-visible 턴, KB cue를 조립하게 했고, 새 테스트가 DB case_digest·직전 session_summary·client-visible pinned_fact가 다음 턴 EngineMessage의 L2/L4 블록에 들어가며 raw 이름은 [NAME]으로 마스킹되는지 검증한다. 검증: M2 focused 68 passed, py_compile.

68차 적용(2026-06-28): refactor-governance P1 delete-only로 routes/sessions.py의 미사용 _load_prev_case_summary()와 죽은 _LEARNER_VISIBLE_AI_ROLE 상수를 제거했다. 동작 변경 없이 다음 M2 작업 표면을 줄인 정리다. 검증: residual grep 0건, M2 focused 68 passed, py_compile.

69차 적용(2026-06-28): refactor-governance P3 계약 축소로 리뷰 도식 ReviewPhaseSegment.key/label, SessionReviewResponse.reachedPhase, 평가 조회 EvaluationSummary.stage, 평가 트리거 응답 stage, 교수 콘솔 TeacherSessionSummary/TeacherGrowthPoint stage를 OpenAPI union으로 좁혔다. 공유 카드 reachedPhase와 live-coach event stage는 저장 payload/legacy 호환 검토가 필요해 별도 후속으로 남겼다. 검증: backend focused 50 passed, npm run check:api-types, npm run typecheck, npm run build.

70차 적용(2026-06-28): H4 마스킹 경계를 refactor-governance 기준으로 좁혀 guardrail.mask_pii() 내부에 선택형 한국어 PII recognizer adapter를 추가했다. adapter는 import-time hard dependency가 아니며 실패 시 예외를 삼키고 기존 regex fallback을 마지막 안전망으로 유지한다. fake adapter 회귀는 regex가 못 잡는 별명/기관 span을 [NAME]/[ORG]로 마스킹하고 같은 문장의 전화번호는 후단 regex가 [PHONE]으로 처리하는지, adapter 실패 시에도 regex fallback이 유지되는지 검증한다. span 중복 처리는 문자별 set 할당 대신 정렬된 last_end 비교로 정리했다. 검증: H4 focused 47 passed, CLI fixture 15/15 pass, py_compile.

71차 적용(2026-06-28): refactor-governance P3 계약 축소 후속으로 공유 카드 PublicSessionShareResponse.reachedPhaseLiveCoachEvent.stage도 OpenAPI enum/null 계약으로 좁혔다. 저장된 legacy JSON/TEXT 값은 stage_label_or_none() validator에서 한글 라벨 또는 기존 code key만 살리고, 빈 문자열·임의 문자열은 null로 낮춰 기존 공유 링크·live-coach 이력이 500으로 깨지지 않게 했다. 세션 UI 코칭 이력은 null stage를 단계 미상으로 표시한다. 검증: share/live-coach focused 43 passed, npm run check:api-types, npm run typecheck, npm run build.

72차 적용(2026-06-28): refactor-governance P3 계약 SSOT 후속으로 stage 라벨과 리뷰 phase key 변환 규칙을 app/stage_contract.py로 분리했다. turn_runtime.py의 legacy code 정규화, session_read_model.pyStageLabel/ReviewPhaseKey, routes/eval.py의 nullable summary stage membership 체크가 같은 모듈을 참조한다. OpenAPI 응답 shape는 유지하고, enum/legacy/unknown 처리만 한 곳으로 모았다. 검증: stage contract focused 42 passed, npm run check:api-types, npm run typecheck, npm run build.

73차 적용(2026-06-28): C1 워크시트 교수자 수동 검수 골격을 추가했다. 기존 app.session_review_statusworksheet_status/worksheet_note/worksheet_reviewed_at을 붙이고, PUT /teacher/sessions/{id}/review-status가 승인·수정요청·반려 결정을 저장한다. /sessions/{id}/reviewteacherReview는 교수자/관리자에게만 이 결정을 노출하고, SessionReview 교수자 카드에는 학습자 저장 워크시트가 있을 때만 수동 검수 버튼을 활성화한다. AI 채점·루브릭 점수·자동 승인·재제출 잠금 정책은 만들지 않았다. 검증: C1 focused 40 passed, API types/typecheck/build, session-review E2E 3 passed.

74차 적용(2026-06-28): refactor-governance P4로 H2 live-coach source pack 캐시 경계를 명시했다. live_coach의 로컬 source pack snapshot은 API 프로세스 생명주기 캐시로 유지하고, 관리자 POST /kb/live-coach/source-packs/syncscripts/sync-persona-sources.pyrefresh=True로 캐시를 비운 뒤 repo 파일을 다시 읽는다. live turn 경로에는 매 턴 파일 IO를 추가하지 않았고, RAG content_hash/version 비교와 evaluator-only payload 정책은 유지했다. 파일 변경 뒤 stale hash가 refresh로 새 hash/version bump에 반영되는 회귀를 추가했다. 검증: source pack focused 9 passed, H2 related 44 passed, sync CLI help, py_compile.

75차 적용(2026-06-28→29): 다크 UI v2 시안을 실제 코드 적용 라운드로 완료했다. P1 라이브 상담 세션은 Session.tsx/session.css 구조까지 조정해 내담자 무대 발화, 좌측 세션 진행, 우측 라이브 신호/안전 점검을 다크 훈련 화면으로 재구성했다. P2 회기 리뷰는 learner filled 상태를 3열 workbench로 바꿔 요약/흐름, 축어록, 평가 rail, 워크시트를 분리했고 empty review는 2열 이하로 유지했다. P3 학습자 홈은 대시보드에서 연습 대상 레일을 제거하고, 진행 회기/리뷰 대기/최근 평가/라포 흐름을 상단 CTA 바로 올렸으며, 오늘 이어갈 회기·AI 코치·다음 연습 추천·최근 피드백을 하나의 lh-work-cluster 작업 묶음으로 재배치했다. 오른쪽 레일은 최근 기록, 리뷰 대기, 반복 대상만 담당한다. 새 증거 캡처는 docs/design-verification/full-pages/02-learner-home-{desktop,tablet,mobile}.png, 03-session-active-{desktop,tablet,mobile}.png, 04-session-review-{desktop,tablet,mobile}.png, 04-session-review-empty-{desktop,tablet,mobile}.png다. 검증: npm run typecheck, npm run build, layout-visual-gate.spec.ts single-run 9 passed.

76차 적용(2026-06-28): refactor-governance P2로 M2 digest 계약 경계를 고정했다. SessionDigestInput/SessionDigestResult/SessionSummaryWrite를 추가해 LLM worker 후보가 raw text, evaluator-only turn, 평가 payload, CCD, deterministic carry를 우회하지 못하게 했다. /sessions/{id}/enddigest_pending은 여전히 CompressionJob 생성 여부를 알리는 비동기 압축 필요 신호일 뿐이며, live provider 압축·운영 품질 검증 완료를 뜻하지 않는다. 검증: M2 focused 74 passed, npm run check:api-types, npm run typecheck, py_compile.

77차 적용(2026-06-28): H1 Phase 3 KPI report 계약을 phase3_kpi_contract.py로 모아 exporter/checker/test의 metric 이름·필수키·status 중복 선언을 줄였다. kpi_report.json metric은 computed_prepostdesign_pending status를 구분하므로, 3척도 pre/post로 계산 가능한 파일럿 evidence와 평가설계 전이라 계산하지 않는 KPI를 기계적으로 분리한다. 공식 효과성 판정·통계해석·20명 파일럿 evidence는 계속 외부/파일럿 gate다. 검증: H1 KPI focused 10 passed, H1 broad 46 passed, exporter/checker help, py_compile.

78차 적용(2026-06-29): refactor-governance P3로 L1 Node 전환 준비의 gateway-default 모델 sentinel을 app/contracts/engine_gateway.py 계약 상수와 normalize_engine_gateway_model()로 올렸다. FastAPI EngineClient, 현재 Python gateway, orchestrator stream audit/done fallback, 관리자 기본 engine config가 같은 sentinel을 참조하고, engine_gateway_schema.v1.json과 Node conformance runner도 기본 라우팅 sentinel을 검증한다. gateway-default는 실제 provider 모델명이 아니라 explicit --model을 보내지 않는 gateway 기본 라우팅 신호다. 검증: py_compile, Node conformance OK, 당시 gateway contract focused 20 passed, L1 focused 55 passed, admin/runtime/evaluator focused 40 passed.

79차 적용(2026-06-29): refactor-governance P3/P8로 GenerateResponse 구조화 JSON fallback을 structured_payload_from_response() 계약 helper로 모았다. evaluator, live-coach, persona draft route가 structured field 우선, fenced JSON, embedded JSON object fallback을 같은 경계에서 처리하므로 Node gateway 교체 시 보존해야 할 legacy response 해석 규칙이 한 곳에 남는다. 학습자 SessionReview 입력은 name/autocomplete/aria-label과 공유 focus token(--border-focus, --focus-ring)으로 정리했고, 발화 이동 버튼에도 목적 발화 aria-label을 추가했다. 검증: py_compile, Node conformance OK, gateway contract 23 passed, backend focused 89 passed, npm run check:api-types, npm run typecheck, npm run build, session-review E2E 3 passed, layout visual gate 9 passed.

80차 적용(2026-06-29): refactor-governance P3로 H3/L1 페르소나 draft generation 계약을 app/persona_generation_contract.py로 분리했다. 이 모듈이 draft structured schema, prompt bundle id/version/hash, GenerateResponse payload extraction, generated draft coerce/default fallback을 소유한다. routes/personas.py는 teacher/admin auth, source 등록·조회, RAG evidence, engine 호출, provenance 조립, HTTP error mapping을 계속 소유한다. 검증: py_compile, persona contract+review 39 passed, backend focused 95 passed, Node conformance OK, npm run check:api-types, npm run typecheck.

81차 적용(2026-06-29): refactor-governance P2/P3로 engine structured payload 계약과 session evaluation write packet 경계를 더 줄였다. evaluator/live-coach의 로컬 _structured_payload() alias를 제거해 structured_payload_from_response()를 직접 호출하게 했고, SessionEvaluationWriteapp.session_evaluation 저장 packet(status/source/scope/stage/payload/error)을 소유한다. routes/sessions.pyroutes/eval.py는 named packet을 만들고, SQL·fallback cache·응답 shape는 유지한다. 검증: py_compile과 당시 focused suite 통과, 이후 최신 L1 focused 120 passed와 Node conformance OK로 재검증.

82차 적용(2026-06-29): refactor-governance P8로 Session.tsx의 음성/세션 UI 파생 상태 계산을 sessionVoiceStatusView() helper로 분리했다. 마이크 busy/label, 세션 상태 label, transcript live label, 텍스트 입력 차단, 응답/음성 상태 chip 계산을 named view-model 경계에서 유지한다. API/DB 계약, 세션 시작·전송·종료, voice WebSocket/TTS lifecycle, live-coach payload, DOM/CSS는 변경하지 않았다. 검증: npm run typecheck, npm run build, session-mvp 1 passed, voice-success 2 passed, session-layout desktop/mobile 8 passed.

83차 적용(2026-06-29): refactor-governance P3로 학습자/교수자 성장 지표가 턴 평가 기법 라벨을 읽는 경계를 session_metrics.turn_technique_label()로 명시했다. DB 정규화 후 재수화되는 TechniqueTag.label_ko를 우선 사용하고, 기존 label/name/id/code legacy fallback은 유지한다. alternative_utterances는 future adapter 추출 전에 문자열 배열과 text/suggestion dict 배열을 모두 row로 정규화하는 호환 테스트로 고정했다. 검증: py_compile, evaluation/learner/teacher focused 59 passed.

84차 적용(2026-06-29): refactor-governance P2로 Session.tsx의 음성 guard/view-model 경계를 한 번 더 줄였다. isVoiceStatusBusy()가 마이크 busy 판정을 소유하고, sessionVoiceStatusView()가 마이크 disabled와 aria label까지 반환해 JSX와 toggleMic()의 중복 조건을 제거했다. recording은 계속 busy가 아니므로 두 번째 마이크 클릭으로 발화 전송이 가능하다. API/DB 계약, WebSocket/TTS lifecycle, STT/TTS provider 동작, live-coach payload, DOM/CSS는 변경하지 않았다. 검증: npm run typecheck, npm run build, session-mvp 1 passed, voice-success 2 passed, session-layout desktop/mobile 8 passed.

85차 적용(2026-06-29): refactor-governance P3로 Node 전환 계약 검증의 gateway-default sentinel 중복을 줄였다. scripts/check-engine-gateway-contract.mjs는 더 이상 sentinel 문자열을 자체 상수로 들고 있지 않고, engine_gateway_schema.v1.jsonx-engine-gateway-default-model-sentinel extension을 읽어 schema artifact를 SSOT로 검증한다. 공개 런타임 SSOT도 재확인해 custom domain asset을 assets/index-Cz4PBoO3.js/assets/index-DtVTvS9j.css로 갱신했고, OAuth start는 동작하지만 인증된 /turn proof는 여전히 owner storageState gate로 남겼다. vnet.18ka.net/api-vnet.18ka.net DNS A record는 0건이라 DONE 처리하지 않는다.

86차 적용(2026-06-29): refactor-governance P2/P3로 Session mic capture를 AudioWorklet-first 구조로 전환하고 기존 MediaRecorder를 fallback으로 남겼다. Worklet은 mono PCM16 chunk를 /voice/ws binary frame으로 보내고, control packet은 format=pcm, sample_rate, channels, sample_width를 명시한다. 백엔드는 pcm 업로드를 STT 호출 직전 RIFF/WAV로 정규화해 raw PCM을 audio/wav로 오인하던 계약 틈을 닫았다. 실제 Deepgram streaming, 물리 마이크, public WSS, 50분 양방향 실측은 계속 외부/실측 gate다. 검증: app/test_voice_ws.py 11 passed, npm run typecheck, voice-success chromium-single-run 2 passed.

87차 적용(2026-06-29): refactor-governance P3로 /voice/ws에 provider-neutral stt_result control을 추가해 EOT helper를 route 경계에 연결했다. 새 control은 text, final, silence_ms, provider_events를 받아 assess_end_of_turn()이 ready를 판단하고, pending이면 턴 실행 없이 state=listening으로 돌아간다. ready일 때만 transcript를 emit하고 _run_turn_and_speak()로 진행한다. 기존 audio_start→binary→audio_end, text_turn, ping/close 계약은 유지했다. 실제 Deepgram interim/final WSS 연결과 public WSS/물리 마이크/50분 실측은 여전히 남은 gate다. 검증: py_compile, app/test_voice_ws.py app/test_voice_service.py 27 passed.

88차 적용(2026-06-29): refactor-governance P3로 Node conformance runner의 stream event/payload 검증을 schema-driven으로 바꿨다. scripts/check-engine-gateway-contract.mjs는 더 이상 token/done/error 이벤트 목록과 payload 필드를 로컬 상수·분기로 들고 있지 않고, engine_gateway_schema.v1.jsonStreamPacket.oneOf, payload $ref, x-engine-gateway-sse-events를 읽어 golden fixture를 검증한다. raw token text fallback과 data: [DONE] compatibility line은 유지했다. 검증: node scripts\check-engine-gateway-contract.mjs --json, 당시 gateway/backend focused suite 통과, 이후 최신 L1 focused 120 passed로 재검증.

89차 적용(2026-06-29): refactor-governance P3로 SessionEvaluationWritefrom_result()/from_error() factory를 추가해 session evaluation 저장 packet 생성 규칙을 한 곳으로 모았다. routes/sessions.pyroutes/eval.py는 더 이상 status/source/scope/stage/payload/error 묶음을 직접 조립하지 않는다. 성공·평가오류는 result.to_dict()status="ready|error" 규칙을 유지하고, 실행 예외 fallback은 기존처럼 payload={}, error=str(exc)를 저장한다. 검증: py_compile, app/test_evaluation_persistence.py 12 passed, evaluation/learner/teacher focused 53 passed, backend focused 116 passed, residual SessionEvaluationWrite( route/test direct constructor 0건.

90차 적용(2026-06-29): refactor-governance P2로 M2 턴 메모리 전달 경계를 TurnMemory 값 객체로 단일화했다. recall_summary/pinned_facts/recent_turns/kb_behavior_cuesTurnContext.memory에 보관되고, prepare_turn(memory=...)에서 기존처럼 PII 마스킹된 뒤 build_turn_messages(memory=...)로 전달된다. REST/SSE/voice와 재평가 경로는 RecallContext, 최근 client-visible 턴, KB cue를 TurnMemory로 조립한다. 이는 live provider 압축이나 운영 품질 검증 완료가 아니라, Node.js 전환 전 내부 계약 표면을 줄인 구조 개선이다. 검증: py_compile, M2/voice/evaluation focused 115 passed, gateway contract 23 passed, Node conformance OK, 구 ctx.recall_summary/ctx.recent_turns 직접 접근 0건.

91차 적용(2026-06-29): refactor-governance P2로 auth managed-user 생성/재활성화 입력 경계를 ManagedUserUpsertInput dataclass로 고정했다. create_session(), 관리자 POST /admin/users, auth 회귀 테스트의 upsert_managed_user() 호출은 더 이상 email/display_name/role/admin_access/cohort_ids/user_id/external_id/affiliation/account_status/reactivate 키워드 묶음을 직접 넘기지 않고 단일 입력 객체를 만든다. 기존 ManagedUserMemoryInput은 DB→메모리 fallback/store 동기화용, ManagedUserPatch/users/me·온보딩·관리자 수정용 partial update 경계로 유지했다. 외부 API/DB schema/온보딩 정책 변경은 아니며, admin_access·super_admin 위임과 onboarding_required 선차단 동작은 기존 계약을 보존한다. 검증: py_compile, auth/admin/session focused 103 passed, 구 keyword call 0건, npm run check:api-types.

92차 적용(2026-06-29): refactor-governance P3로 현재 Python engine gateway의 응답 메타데이터 중복 선언을 줄이고, Node conformance runner가 gateway-default를 실제 provider 모델명이 아닌 default-routing sentinel로 검증하게 했다. GATEWAY_PROVIDER, GATEWAY_FALLBACK_MODEL_NAME, _response_model_name()/v1/generate/v1/streamprovider/model 반환 규칙을 함께 소유한다. scripts/check-engine-gateway-contract.mjs는 golden fixture의 request model이 schema sentinel과 같고, response/done packet model은 resolved provider model인지 확인한다. wire schema, SSE frame shape, session reuse, error event 동작은 바꾸지 않는 순수 구조 정리다. 검증: py_compile, node scripts\check-engine-gateway-contract.mjs --json OK(defaultModelSentinel=gateway-default), gateway contract 23 passed.

93차 적용(2026-06-29): refactor-governance P2로 Python engine gateway의 메시지 분해 경계를 GatewayPromptParts dataclass로 이름 붙였다. _split_messages()는 더 이상 tuple[str, str]를 반환하지 않고 system_prompt/user_payload를 명시하며, 실제로 쓰지 않던 history 조립 흔적과 주석 모순을 제거했다. 동작은 기존과 같다: system 메시지는 공백 제외 후 \n\n로 합치고, 마지막 user 발화만 이번 턴 payload로 보내며, user가 없으면 session resolution 전에 /v1/generate//v1/stream 모두 400이다. 검증: py_compile, node scripts\check-engine-gateway-contract.mjs --json OK, gateway contract 27 passed, L1 backend focused 120 passed.

94차 적용(2026-06-29): refactor-governance P2로 M2 LLM digest 후보의 local quality harness를 추가했다. DigestQualityAssessment/SessionDigestWorkerOutcomebuild_llm_digest_worker_outcome()이 빈/짧은 digest, raw forbidden substring, 내부 평가·CCD·상태 marker, 잘못된 S{session_no}: prefix를 reject하고, 통과한 후보만 SessionDigestResult(source="llm")로 승격한다. open_threads와 session/case id는 입력 계약에서 그대로 보존된다. 이는 live provider 호출, 운영 scheduler, 임상 골든셋 품질평가, 재압축 완료가 아니다. 검증: py_compile, py -3.11 -X utf8 -B -m pytest -p no:cacheprovider app/test_session_memory.py -q 20 passed.

95차 적용(2026-06-29): refactor-governance P2/P3로 M2 one-shot session digest worker 경계를 추가했다. app/services/session_digest_worker.pyCompressionJob을 Node-compatible GenerateRequest/EngineMessage로 변환하고, 주입형 engine·audit_hook으로 단발 호출한 뒤 local quality gate를 통과한 결과만 session_summary.digest/compressed_by/token_countcase_profile.case_digest에 idempotent 적용할 수 있게 한다. DB loader는 persisted fallback summary와 client-visible masked transcript만 재구성하며 raw text, evaluator-only turn, CCD, end_state는 prompt에 넣지 않는다. 이는 provider live run, background scheduler, 임상 골든셋 품질평가, 재압축 완료가 아니다. 검증: py -3.11 -X utf8 -B -m pytest -p no:cacheprovider app/test_session_digest_worker.py app/test_session_memory.py -q 25 passed, py -3.11 -X utf8 -B -m pytest -p no:cacheprovider app/test_session_digest_worker.py app/test_session_memory.py app/test_session_turn_persistence.py app/test_orchestrator_masking.py app/test_runtime_policy.py -q 82 passed.

96차 적용(2026-06-29): M2 digest worker를 운영자가 명시 실행할 수 있도록 scripts/run-session-digest-worker.py dry-run/apply runner를 추가했다. 기본은 metadata-only dry-run이고, --apply를 줘야 accepted 후보를 DB에 반영한다. runner는 load → DB release → engine generate → short apply 순서로 동작해 LLM 호출 동안 DB transaction을 잡지 않는다. digest 본문은 민감할 수 있어 --show-digest를 명시할 때만 출력한다. 이는 실 provider 장시간 운영 완료가 아니다. 검증: py -3.11 -X utf8 -B -m py_compile scripts\run-session-digest-worker.py apps\api\app\services\session_digest_worker.py apps\api\app\test_session_digest_worker.py, py -3.11 -X utf8 scripts\run-session-digest-worker.py --help, M2 focused 25 passed.

97차 적용(2026-06-29): SESSION_DIGEST_WORKER_ENABLED=false 기본값을 두고, opt-in일 때만 세션 종료 성공 뒤 digest worker를 background task로 예약한다. scheduler는 persisted fallback row를 load한 뒤 DB connection을 놓고 engine을 호출하며, accepted plan만 짧은 apply transaction으로 반영한다. 이미 compressed_by가 있는 세션은 loader에서 제외하고, apply도 compressed_by IS NULL CAS로 보호하며, fallback summary 재작성 시 compression metadata를 초기화한다. 이는 bounded/default-off scheduler 골격이며, 실 provider 장시간 운영·임상 골든셋 품질평가·재압축 정책 완료가 아니다. 검증: py_compile, runner --help, M2 focused 30 passed.

99차 적용(2026-06-29): 대시보드 SSOT drift gate를 보강했다. scripts/check-dev-dashboard-ssot.py는 현재 카드 상태(done=25, planned=0, doing=0), CHECK 잔여 0, owner board counts(block=2, decide=7, ext=2), 외부 GATE 상세 6행, 결정 탭 7행, 자유연습 F-10 결정 문구, M2 30/87 검증 수치, default-off scheduler/CAS 문구, 실 provider·임상 골든셋·재압축 GATE 보존, stale 82/25/26 passed 및 낡은 결정 8건 문구 제거를 함께 확인한다. 검증: py_compile, py -3.11 -X utf8 scripts\check-dev-dashboard-ssot.py --json PASS. 아래 적용 노트 일부는 historical snapshot이라 당시 통과 수치를 그대로 보존한다.

100차 적용(2026-06-29): 관리자·교수자 메일링 시스템 1차를 추가했다. 신규 외부 로그인 pending 계정은 account_pending_approval:{user_id}, 회기 종료 후 평가/error record 저장 완료 세션은 session_review_ready:{session_id}, 명시 테스트 메일은 admin_test_email:{uuid} idempotency key로 app.notification_event/app.notification_delivery에 큐잉된다. 테스트 메일은 대량 오발송을 피하기 위해 AUTH_SUPER_ADMIN_EMAILS 대상에게만 큐잉한다. 메일 HTML은 Vignette 톤앤매너(종이 배경, 세이지 CTA, 8px 카드)를 inline style로 유지하고, 본문에는 축어록·평가 전문을 넣지 않고 /admin/users, /teach/session/:sessionId/review, /admin 딥링크만 제공한다. NOTIFICATION_EMAIL_PROVIDER=smtpSMTP_*가 설정된 경우 실제 발송하며, GET /admin/notifications, POST /admin/notifications/process, POST /admin/notifications/test, scripts/run-notification-worker.py로 delivery 상태와 재시도를 운영한다.

101차 적용(2026-06-30): yunchan@twentyoz.kr처럼 기본 역할이 learner로 복원되는 슈퍼관리자가 타 학습자 회기 리뷰 딥링크를 열 때 session does not belong to user 403에 갇히던 문제를 고쳤다. /sessions/{id}/review는 본인 학습자 리뷰를 우선 시도하고, 실패한 경우 슈퍼관리자만 admin 감독자 읽기 주체로 재시도한다. 일반 learner와 단순 admin_access 위임 계정의 타인 회기 접근 차단은 유지한다. 프론트는 같은 403뿐 아니라 이미 teacherReview가 포함된 감독자 200 응답도 /teach/session/:sessionId/review로 정규화해 학습자 전용 사전/사후·공유 UI가 보이지 않게 한다. 검증: app/test_rbac_idor.py 11 passed, RBAC/auth/teacher focused 46 passed, supervisor route E2E 2 passed(PLAYWRIGHT_PORT=5176), npm run typecheck, npm run build.

102차 적용(2026-06-30): 관리자(role=admin)가 학습자·교수자·관리자 워크스페이스를 모두 직접 오갈 수 있도록 권한 경계를 정리했다. 백엔드는 Principal.can_access_role()role=admin이면 모든 역할 접근을 허용하고, require_role()은 super_admin뿐 아니라 admin도 허용 역할로 승격한다. 학습자 전용 경로(/consent accept/withdraw, /voice/ws)의 super_admin-only 승격 분기도 can_access_role(Role.LEARNER) 기준으로 바꿔 admin이 동일하게 통과한다. 프론트는 auth.tsxcanAccessRole()에 admin 전체 접근을 반영하고, 역할 전환 메뉴는 accessibleRolesFor() 단일 헬퍼가 소유하며, Sidebar admin 내비에 운영 홈·교수 콘솔·학습자 홈·학습·기록 진입을 추가했다. 외부 API 계약·DB schema·승인 게이트(account_status)·super_admin 권한 부여/회수 동작은 바꾸지 않았다. 검증: npm run typecheck, npm run check:api-types, py -3.11 -X utf8 -B -m pytest app/ -q 290 passed(RBAC/runtime 30 포함), admin 워크스페이스 내비 E2E 1 passed, layout 시각게이트 9/9, session-layout 4 passed.

103차 적용(2026-06-30): 소유자(윤찬) 결정 4건이 확정되어 owner 보드 결정 카드 7→3으로 줄었다. (1) s2s 2차 PoC 유지 — 캐스케이드 1차를 운영 기준으로 두면서 voice-s2s-poc.md 비교 PoC를 계속 연다(최종 채택은 비교 리포트 이후). (2) fast-loop 외부 폴백 허용 — 로컬 상주 분류기 기본 + 외부 Haiku/Solar 폴백 허용, 전송 시 데이터주권·보존·동의 가드 적용. (3) 재귀학습 fine-tuning 포함 — few-shot 자동갱신에 더해 fine-tuning까지 범위에 포함하되, 데이터셋은 동의·추가 축어록 수급 게이트가 닫힌 뒤 구성. (4) 서비스 음성 = 대체 TTS provider — 상업 라이선스가 명확한 대체 provider 채택, Higgs synthetic·dev sample provider는 개발 플래그로만 유지, 실존 인물/성우 ref 금지 유지. 네 결정 모두 방향 확정이며 구현/실측은 후속 build 항목으로 남는다. 남은 owner 결정은 평가설계(H1 κ/ICC), 운영 보존·에스컬레이션, 추가 축어록 수급 3건이다. SSOT drift 게이트(check-dev-dashboard-ssot.py)의 기대 카운트도 결정 3·decision panel 3행으로 동기화했다.

104차 적용(2026-06-30): 남은 소유자 결정 3건이 확정되어 owner 결정 7건이 전건 확정(결정 필요 3→0)됐다. (1) 평가설계 H1 — 평가자 신뢰도 κ≥0.70 & ICC≥0.75, 환각률 ≤3%, 독립표본 t-검정(α=0.05), 20명 실험/통제군 무작위 배정, 단회기 50분·3척도 pre-post 유지. (2) 운영 보존·에스컬레이션 — 헬스 raw 90일·rollup 365일, escalation 운영자 수동 승인, SLA 미표기(관측 샘플 이력 유지), 담당 그룹 자동 배정 미도입. (3) 추가 축어록 — 20건을 1개월 내 수급. 이 결정들은 설계·정책 확정이며, KPI threshold 반영·retention 기본값 적용·실제 수급/파일럿 evidence·통계해석은 후속 build/GATE로 남는다. 즉 owner 보드의 남은 항목은 모두 외부 증거·기관 의존(공개 OAuth 실 /turn, vnet DNS, 한신대 거버넌스, 임상팀 콘텐츠, 20명 파일럿·법무·물리 실측)이며, 운영 원칙상 E2E/외부 증거 없이는 DONE으로 체크하지 않는다. SSOT drift 게이트의 기대 카운트도 결정 0·decision panel 0행으로 동기화했다.

105차 적용(2026-06-30): 공개 배포 도메인(vnet.18ka.net)에서 슈퍼관리자가 관리자 페이지 전체를 블랭크로 보던 문제를 고쳤다. 원인은 권한이 아니라 vite preview 서버의 host 검증이었다. 배포는 npm run preview를 cloudflared 터널로 공개 도메인에 연결하는데, vite.config.tspreview.allowedHosts가 없어 공개 Host 요청이 Blocked request. This host is not allowed. 403 텍스트만 받아 SPA가 통째로 로드되지 못했다(에러 바운더리 부재로 전체 흰 화면). server.allowedHosts와 동일 목록을 preview에도 적용하고 기본 허용에 vnet.18ka.net/api-vnet.18ka.net/vignette.chanpaca.net를 추가했다. 검증: 재현(curl -H "Host: vnet.18ka.net" 127.0.0.1:5174 → 수정 전 Blocked, 수정 후 200+정상 index), 로컬 dev·preview에서 일반/슈퍼 관리자 전 admin·teach·learn 페이지 정상 렌더(pageerror 0), npm run typecheck. 회귀 방지로 npm run check:preview-hosts(scripts/check-preview-hosts.mjs)를 추가해 preview를 띄워 공개 Host 3종 200 허용·임의 Host 403 차단을 행동 검증한다(공개 3 allowed·unlisted blocked 통과). 공개 OAuth 실 /turn 증명은 여전히 별도 BLOCK이다.

106차 적용(2026-06-30): 대시보드 자체를 레드팀 대상으로 삼아 unit + E2E 게이트를 추가했다. scripts/test_dev_dashboard_ssot.py는 SSOT checker import/stateless/owner parser를 검증하고, apps/web/e2e/dev-dashboard.spec.ts는 local file, 127.0.0.1, localhost origin에서 필터 오순서·빠른 재시도·Enter/Space 키보드·details/tabs 토글·hash anchor·링크/이미지 무결성·desktop/mobile overflow를 확인한다. 같은 라운드에서 live public API https://api-vignette.chanpaca.net/health/personas가 Cloudflare 530/error code 1033으로 실패하는 것을 발견했고, 원인은 Docker Desktop 중단으로 vignette-dev-db가 꺼진 상태였다. Docker Desktop/DB 재기동 후 scripts/start-public-runtime.ps1를 다시 실행해 public health 200, unauth /personas 401, auth config 200, Google login start 302, watchdog healthy: engine, api, web-preview, cloudflared, public-api까지 복구를 확인했다. 검증: SSOT unit 3 OK, dashboard checker PASS, dev-dashboard E2E redteam 10 passed, backend RBAC/auth/teacher 47 passed, supervisor route E2E 2 passed, npm run typecheck, npm run build.

107차 적용(2026-07-01): 하린/P6 102분 회기의 SUPERVISOR AI 평가 실패를 실제 DB와 감사 로그로 추적했다. 종료 시각과 평가 row 갱신 시각 차이가 45초였고, 기존 회기말 평가 background task가 wait_for(..., 45.0) 하드캡에서 asyncio.TimeoutError를 맞은 뒤 str(exc)==""를 저장해 payload={}, error=""가 된 것이 원인이었다. 회기말 평가는 SESSION_EVALUATION_TIMEOUT 또는 ENGINE_TIMEOUT을 쓰도록 바꾸고, 빈 예외 문자열은 예외 타입/명시 메시지로 저장한다. 명시 재평가 API는 실패 결과를 먼저 저장한 뒤 502/503으로 노출한다. 프론트는 종료 실패 시 리뷰로 이동하지 않고 alert를 보여주며, 평가 대기 리뷰는 제한 폴링으로 ready 전환을 기다리고, 교수자 검토 화면에는 AI 평가 재시도 버튼을 추가했다. 재시도 실패 UI 유지와 저장된 평가 실패 row의 read-model 노출도 회귀 테스트로 고정했다. 모바일 코칭 모드에서 우측 컬럼 숨김 때문에 AI 튜터 말풍선이 보이지 않던 회귀도 함께 수정했다. 검증: backend 전체 297 passed, npm run check:api-types, npm run typecheck, npm run build, session-review desktop/mobile 16 passed, session-mvp desktop/mobile/single-run 5 passed, session-layout desktop/mobile 8 passed, layout-visual-gate 9 passed.

108차 적용(2026-07-01): mock E2E가 가리던 브라우저 실제 SSE 저장 경로를 추가로 검증했다. 기존 session-persistence.spec.ts는 real API/DB를 쓰지만 /api/sessions/{id}/turn를 직접 호출해 UI의 openSessionStream() → backend /streamfinalize_completed_turn() 저장 경로를 타지 않았다. 새 @single-run 테스트는 /api/health에서 db=true, engine=true를 확인한 뒤 실제 Session UI에서 회기를 시작하고, 학습자 발화를 브라우저 fetch stream으로 보내며, 입력창이 다시 enabled 될 때까지 stream 완료를 기다린 다음 GET /sessions/{id}/review에서 learner/client 저장 축어록을 확인한다. 최신 session-persistence 묶음 검증: PLAYWRIGHT_PORT=5205 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 7 passed, npm run typecheck passed, 현재 Playwright 수집 기준 162 tests in 18 files.

109차 적용(2026-07-01): 원래 E2E silent error 목표에 맞춰 AI 튜터와 위기 게이트 경로를 추가로 좁혔다. POST /sessions/{id}/live-coach는 코칭 생성 뒤 save_live_coach_event() 실패를 except/pass로 묻고 있어, 사용자는 코칭 카드를 봤지만 재로딩/이력에는 사라지는 상태가 가능했다. 라우트에서 저장 실패를 삼키지 않게 하고, 실패가 503으로 표면화되는 백엔드 회귀와 실제 Session UI의 코칭 모드 → 턴 완료 → DB-backed GET /live-coach 이력 → 재로딩 후 C 마커 E2E를 추가했다. 또한 crisis safety/done.conversation_stopped 또는 음성 reply.conversation_stopped가 빈 응답으로 끝날 때 내담자 응답 없음 신호가 안전 게이트를 덮지 않게 막고, 위기 안전 자원 109·입력 disabled·live-coach 미호출을 E2E로 고정했다. 검증: python -X utf8 -m pytest -p no:cacheprovider app/test_session_turn_persistence.py -q 27 passed, PLAYWRIGHT_PORT=5193 npx playwright test e2e/session-mvp.spec.ts --project=chromium-single-run --workers=1 2 passed, PLAYWRIGHT_PORT=5199 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 5 passed, npm run typecheck passed.

110차 적용(2026-07-01): 음성 비언어 메타데이터가 fixture-only로 통과하는 silent gap을 줄였다. db.healthcheck(), runtime table readiness, deploy preflight DB mode는 이제 app.turns.provider_events 하나가 아니라 audio_ref/silence_ms/speech_rate/barge_in/provider_events 5개 컬럼 전체를 확인한다. dev/runtime bootstrap은 누락된 nullable 음성 컬럼도 보강한다. 새 DB-backed @single-run E2E는 실제 세션을 만든 뒤 /api/voice/ws stt_result control로 침묵·끼어듦·provider event를 보내고, GET /sessions/{id}/review에서 제한된 nonverbal 칩으로 파생되는지 확인한다. 검증: python -X utf8 -m pytest -p no:cacheprovider app/test_runtime_policy.py app/test_session_turn_persistence.py app/test_voice_ws.py app/test_voice_service.py -q 77 passed, PLAYWRIGHT_PORT=5199 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 5 passed, python -X utf8 -m py_compile app/db.py app/auth_sessions.py app/test_runtime_policy.py ..\..\scripts\check-deploy-preflight.py, preflight skip-db PASS.

111차 적용(2026-07-01): 실제 Session 마이크 UI가 비언어 메타를 만들지 않던 공백을 줄였다. AudioWorklet 캡처는 PCM RMS/peak로 voice activity와 trailing silence를 추정해 audio_endsilence_ms, barge_in=false, browser source provider_events를 보낸다. MediaRecorder fallback은 raw PCM을 볼 수 없어 duration 기반 voice activity만 보낸다. 리뷰 read-model은 turn-level silence_ms가 이미 침묵 칩을 만들면 provider silence 칩을 중복 노출하지 않는다. 검증: npm run typecheck, backend voice/session focused 77 passed, PLAYWRIGHT_PORT=5197 npx playwright test e2e/voice-success.spec.ts --project=chromium-single-run --workers=1 2 passed, 최신 PLAYWRIGHT_PORT=5205 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 7 passed, 현재 Playwright 수집 기준 162 tests in 18 files.

112차 적용(2026-07-01): 교수자 회기 리뷰 데스크톱에서 overview/transcript가 여러 CSS Grid row를 가로질러 오른쪽 검토 rail 높이를 나눠 먹으며 중앙에 큰 빈 row가 생기던 문제를 제거했다. 1181px 이상 교수자 리뷰는 main column + review rail 2열 wrapper로 분리하고, main 내부는 요약 전체폭, 차트/회기 흐름 2열, 축어록 전체폭으로 배치해 서로 다른 rail 높이가 빈공간을 만들지 않게 했다. 회귀 방지로 layout-visual-gate.spec.ts에 교수자 리뷰 폭별 dead vertical gap 검증을 추가했다. 검증: npm run typecheck, npm run build, session-review desktop 8 passed, layout-visual-gate 10 passed, session-layout desktop/mobile 8 passed.

113차 적용(2026-07-01): 학습자 /learn/practice 페르소나 리스트가 긴 한글 주호소 요약에서 카드 내부를 클립하던 문제를 수정했다. .lh-list-pane의 viewport 고정 높이와 내부 스크롤을 풀고, .lh-personas/.lh-persona가 콘텐츠 높이를 그대로 만들게 했으며, .lh-persona__summary 3줄 clamp를 제거했다. learner.spec.ts에는 각 페르소나 카드의 summary/body/card scroll overflow가 0인지 재는 regression guard를 추가했다. 검증: npm run typecheck, npm run build, 브라우저 rect smoke 1095px/1440px에서 카드 overflow 0 및 문서 가로 overflow 0. 현재 로컬 127.0.0.1:8000/health가 timeout이라 real API 기반 전체 learner.spec.ts는 이번 패스에서 미실행.

114차 적용(2026-07-01): 회기 종료 후 background deep 평가가 실제 durable DB row로 저장되는지 fixture 없이 검증했다. _schedule_session_evaluation()은 생성한 task를 반환하고 done callback에서 crash/cancel을 로그로 관찰하며, 평가 결과·timeout/error 저장이 durable store에 닿지 않으면 명시 error 로그를 남긴다. 교수자 명시 재평가 API도 평가 산출물이 생성됐지만 저장 실패하면 503으로 표면화한다. GET /eval/sessions/{id}/evaluationstatus/error/durable을 노출해 캐시 착시와 DB 저장 증거를 구분한다. 새 DB-backed E2E는 학습자 세션 생성→턴→종료→teacher 로그인→/eval/.../evaluation polling→교수자 리뷰 UI 평가 완료까지 실제 API/DB/엔진으로 확인한다. 검증: API 전체 309 passed, npm run check:api-types, npm run typecheck, PLAYWRIGHT_PORT=5205 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 7 passed, PLAYWRIGHT_PORT=5203 npx playwright test e2e/session-review.spec.ts --project=chromium-desktop --project=chromium-mobile --workers=1 16 passed, 현재 Playwright 수집 기준 162 tests in 18 files.

115차 적용(2026-07-01): 본래 E2E goal의 AI 평가 축을 계속 이어서 검증했다. 새 DB-backed @single-run은 학습자 세션과 턴을 실제 DB/API/엔진으로 만든 뒤 교수자 POST /eval/sessions/{id}/reevaluate를 호출하고, durable app.session_evaluation row와 GET /eval/.../evaluation/GET /sessions/{id}/review평가 완료 반영을 확인한다. 추가 backend focused 회귀는 종료 회기가 timeout+grace 이후에도 evaluation row 없이 남을 때 교수자 read-model이 무한 평가 대기로 고착되지 않고 평가 실패AI 평가 재시도가 필요합니다 사유를 표면화하는지 검증한다. E2E 문서는 route fixture UI 회귀와 DB-backed 증거를 분리해 표시하도록 정리했다. 검증: PLAYWRIGHT_PORT=5237 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "explicit teacher session reevaluation" 1 passed, py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_session_turn_persistence.py -k "session_evaluation or stale_missing" -q 3 passed, 현재 Playwright 수집 기준 181 tests in 19 files.

116차 적용(2026-07-01): session evaluation startup recovery로 종료 평가 background task 유실 공백을 줄였다. API 기동 뒤 SESSION_EVALUATION_TIMEOUT/ENGINE_TIMEOUT + grace보다 오래됐고, client-visible turn은 있지만 durable app.session_evaluation row가 없는 종료 회기를 evaluator AI context로 조회해 기존 session-end 평가 생성 경로를 재예약한다. 같은 session_id의 process-local 중복 background 평가는 in-flight set으로 막는다. 자동 종료 평가 DB-backed E2E도 같은 row가 교수자 리뷰뿐 아니라 /teacher/dashboardevaluation_status=ready, review_ready=true, supervisor_state=평가 완료로 반영되는지 확장했다. 검증: py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_notifications.py app/test_session_turn_persistence.py app/test_evaluation_persistence.py -k "session_evaluation or missing_session_evaluation or scheduled_session_evaluation" -q 16 passed, npm run typecheck passed, PLAYWRIGHT_PORT=5238 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "finishes session end evaluation" 1 passed. 후속 리스크는 다중 프로세스 durable claim/job table 없이 startup sweep만으로는 여러 API instance 간 소유권을 완전히 보장하지 못한다는 점이다.

115차 적용(2026-07-01): 교수자 학생 분석을 /teach 대시보드에서 분리해 좌측 메뉴의 /teach/analysis 전용 작업면으로 이동했다. 교수 콘솔은 검토 큐·위기 알림·페르소나 검수·최근 회기 triage만 맡고, 학생 분석은 전체 학습자 검색 테이블을 먼저 보여준다. 각 학습자는 한 줄 행으로 표시하고, 우측 펼침 버튼은 행 아래에 미니 추이·기법 태그·최근 기록을 확장한다. 학습자 이름 또는 상세 보기 버튼은 ?learner= 상세 드릴다운으로 이동하며, 상세 화면은 추이·전체 회기·단계 분석 탭으로 선택 학습자의 전체 회기 이력을 나눈다. 회귀 방지로 teacher.spec.ts는 콘솔에 분석 패널이 없고 메뉴를 통해 학생 분석 페이지로 이동한 뒤 검색·행 펼침·상세 진입·전체 회기 탭을 확인하며, layout-visual-gate.spec.ts는 학생 분석 목록/상세 화면을 7개 폭에서 별도 캡처·검사한다. 검증: npm run typecheck, npm run build, npm run check:api-types, PLAYWRIGHT_PORT=5215 npx playwright test e2e/teacher.spec.ts --project=chromium-single-run --workers=1 9 passed, PLAYWRIGHT_PORT=5217 npx playwright test e2e/layout-visual-gate.spec.ts --project=chromium-single-run --workers=1 12 passed, 현재 Playwright 수집 기준 166 tests / 18 files.

116차 적용(2026-07-01): 원천문서 갭 E2E 목표에 맞춰 C1/C2 silent failure를 추가로 닫았다. C1은 학습자가 저장한 사례개념화 워크시트가 app.case_worksheet를 거쳐 교수자 검토 화면 read-only 값으로 복원되고, 교수자 수정요청 검수 메모가 teacherReview.worksheetStatus/worksheetNote로 재조회되는지 실제 브라우저/API/DB E2E로 고정했다. C2는 app.safety_events가 runtime bootstrap/healthcheck에서 빠져 DB 정상처럼 보일 수 있던 구멍과, jsonb codec 위에 이미 직렬화한 문자열을 넘겨 detail이 JSON string으로 저장되던 구멍을 수정했다. record_safety_event()는 RLS용 ai_context=true로 저장하고, alert list 실패는 non-dev에서 fail-closed한다. 검증: python -X utf8 -m pytest -p no:cacheprovider app/test_session_turn_persistence.py app/test_teacher_dashboard.py app/test_runtime_policy.py -q 59 passed, PLAYWRIGHT_PORT=5228 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "case worksheet|crisis safety" 2 passed, 현재 Playwright 수집 기준 166 tests in 18 files.

117차 적용(2026-07-01): 관리자가 관리 콘솔에 들어가도 비어 보일 수 있던 권한/라우팅 경계를 닫았다. 백엔드 require_admin_access()는 raw admin_access 플래그 대신 Principal.can_access_role(Role.ADMIN)을 사용해 role=admin 세션의 스테일 플래그를 허용한다. 프론트 OnboardingGate는 승인된 관리자 또는 admin_access 계정이 /admin*에 있을 때 학습자 온보딩으로 우회시키지 않고, 루트/승인대기 복귀도 관리 콘솔로 보낸다. 학습자·교수자 공간의 온보딩 게이트와 미승인 계정의 /pending 게이트는 유지한다. 검증: backend admin/auth focused 13 passed, npm run typecheck, npx playwright test e2e/admin.spec.ts --project=chromium-desktop --project=chromium-mobile --workers=1 --grep "approved admin without onboarding" 2 passed, 현재 Playwright 수집 기준 175 tests in 19 files.

118차 적용(2026-07-01): 코칭 모드 사용권을 회기별 기본/최대 3회로 제한하고, 좋은 발화가 실제 내담자 변화 신호로 이어질 때 1개씩 재충전하도록 했다. app.live_coach_events는 기존 코칭 payload에 더해 event_type(use/recharge), credit_delta, credit_balance, reason을 저장한다. POST /sessions/{id}/live-coach는 잔여 기회가 없으면 409로 막고, GET /sessions/{id}/live-coachquotacredit_events를 함께 반환한다. 세션 UI는 코칭 기회 점 표시, 사용/충전 펄스, 이력 모달의 사용권 로그를 제공한다. 충전 조건은 appropriateness=pos, rapport_signal>=0.35, 단계 전환 또는 effective_openness 상승을 동시에 만족할 때로 제한했다. 검증: focused py_compile, FastAPI app import 84 routes, python -m pytest app\test_live_coach_privacy.py -q 2 passed, python -m pytest -p no:cacheprovider app\test_session_turn_persistence.py -k live_coach -q 5 passed, npm run generate:api-types, npm run check:api-types, npm run typecheck, npm run build, PLAYWRIGHT_BASE_URL=http://localhost:5173 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "AI tutor coaching history" 1 passed.

119차 적용(2026-07-01): AI 튜터 live coach의 status=degraded 200 fallback이 정상 AI 코칭처럼 보일 수 있는 silent error 후보를 닫았다. 엔진/structured payload 실패 시 규칙 기반 제안 자체는 유지하지만, 세션 UI는 카드, 근거 모달, 이력 모달, 턴 C 마커에서 대체 코칭/AI 응답 대체를 노출한다. DB-backed E2E는 실제 엔진 코칭 응답과 DB history payload가 status=ready, latency_ms>0인지 확인하고, fixture E2E는 degraded fallback이 사용자에게 replacement coaching으로 표시되는지 별도 검증한다. 저장 실패는 기존대로 503 fail-closed라 degraded fallback과 persistence failure를 같은 성공으로 취급하지 않는다. 검증: npm run typecheck, py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_session_turn_persistence.py -k "live_coach" -q 5 passed, PLAYWRIGHT_PORT=5240 npx playwright test e2e/session-mvp.spec.ts --project=chromium-desktop --workers=1 --grep "AI tutor coaching|degraded AI tutor" 2 passed, PLAYWRIGHT_PORT=5241 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "AI tutor coaching history" 1 passed, 현재 Playwright 수집 기준 181 tests in 19 files.

120차 적용(2026-07-01): 본래 E2E goal의 원천문서 gap 축을 이어서 H4/C2 silent failure 후보를 추가로 고정했다. H4 새 DB-backed @single-run은 실제 Session UI stream으로 한국어 이름·기관·전화번호가 포함된 학습자 발화를 보내고, GET /sessions/{id} 상세와 /review 응답 모두 raw 값 없이 [NAME]/[ORG]/[PHONE]으로 마스킹되는지 확인한다. C2는 위기 발화가 교수자 검토용 learner turn으로 저장되지만 client AI reply turn은 저장되지 않고, DB-backed 교수자 안전 큐의 109 알림이 유지되는지 확인한다. 검증: npm run typecheck, PLAYWRIGHT_PORT=5244 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "Korean PII|crisis safety event" 2 passed, 현재 Playwright 수집 기준 181 tests in 19 files.

121차 적용(2026-07-01): 본래 E2E goal의 AI 평가 silent error 축을 이어서 fast-loop 평가 실패와 수동 재시도 경로를 더 좁혔다. 상담 턴 저장은 평가 훅 예외 때문에 막지 않되, 실패는 evaluation.error로 남기고 교수자 리뷰에 턴 평가 실패 노트로 표시한다. evaluator error dict도 원문 예외 메시지를 사용자-facing payload에 싣지 않으며, session_metrics는 error가 있는 fast-loop 결과를 성장 점수와 최근 피드백에서 제외한다. 새 DB-backed UI E2E는 admin engine config를 실패 endpoint로 잠깐 바꿔 실제 app.session_evaluation 실패 row를 만든 뒤 원복하고, 교수자 리뷰의 AI 평가 재시도 클릭이 실제 POST /eval/sessions/{id}/reevaluate → durable ready row → /review 평가 완료/teacher/dashboard ready 상태까지 이어지는지 검증한다. 검증: py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_session_turn_persistence.py -k "fast_loop_evaluation" -q 2 passed, py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_learner_dashboard.py -k "failed_fast_loop" -q 1 passed, npm run typecheck, PLAYWRIGHT_PORT=5245 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "manual AI evaluation retry" 1 passed, 현재 Playwright 수집 기준 181 tests in 19 files.

122차 적용(2026-07-01): 본래 E2E goal의 턴 단위 AI 평가 silent error 후보를 닫았다. 기존 교수자 POST /eval/sessions/{id}/turn은 fast-loop 재평가 결과를 응답 바디로만 돌려주고, app.feedback_scores/app.turn_technique/app.turn_client_state/app.supervisor_comment/app.alternative_utterance에 durable 저장하지 않아 이후 리뷰/분석 read-model이 바뀌지 않았다. replace_turn_evaluation()을 추가해 같은 turn_id의 normalized 평가 row를 교체 저장하고, 저장 실패는 503, 평가 error는 저장 후 502/503으로 표면화한다. normalized evaluation table delete RLS policy도 정적 SQL과 runtime ensure에 동기화했다. 새 DB-backed E2E는 실제 세션/턴을 만든 뒤 교수자 턴 재평가 응답의 technique 라벨이 /review learner turn에 hydrate되는지 확인한다. 검증: py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_eval_routes.py app/test_evaluation_persistence.py -q 29 passed, npm run typecheck, PLAYWRIGHT_PORT=5246 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 --grep "teacher turn reevaluation" 1 passed, 현재 Playwright 수집 기준 181 tests in 19 files.

123차 적용(2026-07-01): 음성 WebSocket에서 transcript final이 먼저 화면에 보인 뒤 턴 저장이 실패하면, 학습자 발화가 DB/review에는 없는데 브라우저 transcript에는 정상 발화처럼 남을 수 있던 silent error 후보를 닫았다. 백엔드는 턴 저장 503을 code=turn_persistence_unavailable로 구조화해 내려주고, Session UI는 해당 임시 발화를 저장 실패 배지로 표시하며 턴 카운트/코칭/리뷰 성공 턴으로 확정하지 않는다. 대기 중 내담자 응답 말풍선은 제거하고 텍스트 입력과 마이크 오류 alert를 복구한다. 검증: py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_voice_ws.py -q 16 passed, npm run typecheck, PLAYWRIGHT_PORT=5248 npx playwright test e2e/session-mvp.spec.ts --project=chromium-single-run --workers=1 --grep "pending voice transcript" 1 passed, 현재 Playwright 수집 기준 182 tests in 19 files.

124차 적용(2026-07-01): 본래 E2E goal을 계속 이어서 AI 튜터/평가 주변 silent error 후보 4개를 추가로 닫았다. GET /live-coach 실패는 빈 이력으로 보이지 않고 이력 모달 alert로 표시한다. POST /live-coachpersistence_source를 반환하고, DB가 아닌 runtime 이력은 Session 카드와 이력 모달에서 임시 저장으로 드러낸다. 기존 pre/post 점수를 지우면 더 이상 저장된 값 기준으로 오인하지 않고 invalid 입력과 저장 차단으로 표시한다. 교수자 대시보드 pending queue는 턴이 0개인 종료 세션을 제외해 리뷰 준비 안 된 세션이 검토 대기처럼 보이지 않게 했다. 검증: C:\Users\encep\AppData\Local\Programs\Python\Python311\python.exe -m pytest apps/api/app/test_teacher_dashboard.py -q 11 passed, C:\Users\encep\AppData\Local\Programs\Python\Python311\python.exe -m pytest apps/api/app/test_session_turn_persistence.py -q -k "live_coach_turn_marks_runtime_persistence_source" 1 passed, npm run typecheck, PLAYWRIGHT_PORT=5251 npx playwright test e2e/session-mvp.spec.ts --project=chromium-desktop --workers=1 --grep "AI tutor|runtime AI tutor" 4 passed, PLAYWRIGHT_PORT=5252 npx playwright test e2e/session-review.spec.ts --project=chromium-desktop --workers=1 --grep "pre/post" 1 passed, 현재 Playwright 수집 기준 186 tests in 19 files. 로컬 작업트리 기준이며 배포 전이다.

125차 적용(2026-07-01): 긴 회기 평가가 기존 짧은 리뷰 polling window를 넘기면 사용자는 평가 대기에 고착된 것처럼 볼 수 있었다. SessionReview의 ready polling window를 약 90초로 늘리고, 10번째 review 응답에서야 평가 완료가 되는 route-fixture 회귀를 추가했다. 검증: npm run typecheck, PLAYWRIGHT_PORT=5253 npx playwright test e2e/session-review.spec.ts --project=chromium-desktop --workers=1 --grep "long-running session evaluation" 1 passed, 현재 Playwright 수집 기준 188 tests in 19 files. 로컬 작업트리 기준이며 배포 전이다. 서브에이전트가 찾은 추가 후보(teacher dashboard stale-missing 불일치, 중복 POST /end 재평가 덮어쓰기, RAG/source-pack skip)는 이번 라운드에서는 후속으로 남겼다.

126차 적용(2026-07-02): 125차 후속으로 남긴 AI 평가 silent error 후보를 닫았다. 교수자 대시보드도 상세 리뷰와 같은 missing session evaluation 규칙을 써서 timeout+grace 이후 evaluation row가 없으면 평가 실패와 재시도 필요 사유를 표시한다. 이미 종료된 세션에 POST /sessions/{id}/end가 다시 들어와도 background session evaluation을 재예약하지 않아 기존 ready row가 새 실패로 덮이지 않는다. AI 평가가 ready가 아니면 교수자 리뷰를 검토 완료로 닫아 pending queue에서 숨길 수 없고, UI의 검토 완료 버튼도 비활성화된다. kb-source-packs.spec.ts는 source-scoped evaluator retrieval 503을 더 이상 skip하지 않는다. 검증: C:\Users\encep\AppData\Local\Programs\Python\Python311\python.exe -X utf8 -m pytest -p no:cacheprovider apps/api/app/test_teacher_dashboard.py apps/api/app/test_session_turn_persistence.py -k "teacher_cannot_close_review_before_ai_session_evaluation_ready or teacher_can_mark_session_review_closed_with_note or end_session_does_not_reschedule_evaluation_for_already_ended_session or session_evaluation or stale_missing" -q 8 passed, npm run typecheck, PLAYWRIGHT_PORT=5254 npx playwright test e2e/session-review.spec.ts --project=chromium-desktop --workers=1 --grep "manual AI retry|long-running session evaluation|retry a failed AI session evaluation|retry fails" 4 passed, PLAYWRIGHT_PORT=5255 npx playwright test e2e/kb-source-packs.spec.ts --project=chromium-single-run --workers=1 1 passed, 현재 Playwright 수집 기준 188 tests in 19 files. 로컬 작업트리 기준이며 배포 전이다.

127차 적용(2026-07-02): 마무리 전 AI 튜터/음성 위기 UI의 silent error 두 개만 좁게 닫았다. 세션 UI의 로컬 코칭 quota가 0으로 stale해도 즉시 차단하지 않고 서버 GET /live-coach quota를 재조회한 뒤 실제 잔여 기회가 있으면 POST /live-coach를 계속 진행한다. quota exhaustion이나 재조회 실패는 이전 코칭 카드 아래에 묻히지 않도록 coachError를 우선 표시한다. 음성 reply.conversation_stopped가 빈 텍스트로 끝나는 위기 경로는 TTS 종료 이벤트를 기다리지 않고 socket을 닫아 109 안전 게이트와 입력 disabled 상태를 유지한다. 검증: npm run typecheck, PLAYWRIGHT_PORT=5259 npx playwright test e2e/session-mvp.spec.ts --project=chromium-desktop --workers=1 --grep "AI tutor|stale empty AI tutor quota|quota exhaustion|degraded AI tutor|voice conversation stop" 7 passed, 현재 Playwright 수집 기준 206 tests in 19 files. 로컬 작업트리 기준이며 배포 전이다. 서브에이전트가 지적한 live coach LLM audit 실패 은폐는 다음 라운드 후보로 남긴다.

128차 적용(2026-07-03): 127차 후속 후보였던 live coach LLM audit 실패 은폐를 닫았다. record_llm_call_audit()가 DB pool 또는 audit.llm_call_log insert 실패로 False를 반환해도 기존에는 generate_live_coaching()이 이를 무시해 정상 status=ready AI 코칭처럼 보일 수 있었다. 이제 live coach는 audit hook의 False 또는 예외를 감사 저장 미확인으로 보고, LLM structured 응답을 버린 뒤 규칙 기반 status=degraded 코칭으로 내려간다. 상담 루프는 막지 않되 사용자에게 정상 AI 코칭처럼 보이지 않게 하는 조치다. 검증: C:\Users\encep\AppData\Local\Programs\Python\Python311\python.exe -X utf8 -m py_compile apps/api/app/services/live_coach.py apps/api/app/test_session_turn_persistence.py, C:\Users\encep\AppData\Local\Programs\Python\Python311\python.exe -X utf8 -m pytest -p no:cacheprovider apps/api/app/test_session_turn_persistence.py -k "live_coach" -q 7 passed. 로컬 작업트리 기준이며 배포 전이다.

129차 적용(2026-07-13): 재부팅 뒤 Chrome이 기존 /admin 탭의 문서 스크롤을 복원하면서 sticky topbar/sidebar만 남고 관리자 본문은 화면 위로 밀리던 silent blank를 재현·수정했다. RED 재현은 길이 2200px 문서에서 scrollY=900을 만든 뒤 persisted pageshow를 보내 수정 전 scrollY=1300과 빈 main을 확인했다. App.tsxhistory.scrollRestoration=manual, pageshow reset, pathname layout-effect와 다음 frame reset을 함께 적용한다. 로컬 focused E2E는 desktop/mobile route 이동·복원 탭 4 passed, typecheck/build passed. Cloudflare Pages production 0daabb1b 배포 뒤 custom domain은 assets/index-BhyOF3rL.js를 서빙하며, 15분 일회성 관리자 세션으로 운영 홈·사용자·권한·티켓과 복원 탭을 공개 사이트에서 확인한 public-admin-visual 3 passed 후 세션을 즉시 삭제했다. 이후 concurrent avatar 변경이 섞인 배포는 Cloudflare Pages rollback API로 0daabb1b에 되돌렸다.

130차 적용(2026-07-13): 운영 /voice/health는 OpenAI 설정을 정상으로 보고했고 실제 운영 키 직접 smoke도 98,133-byte/11.68초 MP3를 반환했지만, 운영 로그에는 사용자의 voice WebSocket 연결이 없어 텍스트 턴 AI 응답이 TTS 경로에 연결되지 않은 공백으로 좁혔다. 인증된 POST /voice/speechsession_id/turn_seq로 소유 회기와 이미 저장된 client-visible 내담자 응답을 다시 검증한 뒤 기존 voice map/OpenAI TTS로 MP3를 반환한다. Session은 텍스트 전송 user gesture에서 AudioContext를 먼저 unlock하고, 합성 Blob을 기존 Web Audio/Analyser 재생기로 보내며 새 턴이 시작되면 이전 요청을 무효화한다. 검증: backend voice 32 passed, API types check, web typecheck, voice-success text TTS+별도 mic 회기 UI focused 1 passed.

144차 적용(2026-07-27): 143차 전수 순회에서 소유자 결정 대기로 남긴 7건을 질문 도구로 전건 결정받아 6건 구현 완료(RED→GREEN, 5개 병렬 구현 에이전트). ① 설정 아바타 변경 — 계정 섹션에 온보딩과 같은 계약(3MB·PNG/JPEG/WebP)의 업로드 컨트롤+미리보기, PATCH /users/me avatar_url 저장 후 refresh로 톱바·레일까지 갱신. ② 동의 관리·철회 전체 흐름 — 새 #set-consent 섹션(실습 동의 시각·약관/개인정보 버전 표시), learner 철회 버튼(2단계 확인)→차단 안내→"다시 동의" 재동의, 세션 프리스타트의 기존 동의 게이트와 연결(철회 함정 상태 해소, dead code였던 withdrawConsent 실사용화), e2e는 고유 계정으로만 철회 수행. ③ 신규 학습자 기초 우선 추천 — 회기 0건 학습자의 기본 선택·첫 회기 준비 카드를 난도 오름차순 첫 페르소나로(starterPersona()), 기록 보유·조회 실패 시 기존 규칙 유지. ④ 학생 분석 테이블 가상화@tanstack/react-virtual(신규 의존성) 세로 가상화, 동적 행 높이 measureElement·펼침 재측정, 300행 fixture에서 렌더 행 <60 검증, 데드스페이스 없게 max-height는 내용 이하로. ⑤ 저작 모드 좌측 레일 마크업 정리 — 어떤 경로에서도 보이지 않던 죽은 DOM(ps-rail)과 전용 CSS 삭제, 특성화 테스트 toHaveCount(0) 강화. ⑥ 감정 밸런스 타임라인 차트 구현(143차 미구현 항목) — 혼합 접근: deep 평가 스키마에 turn_valence(seq·v −1~+1, 극단값 회피 지시) 신설 + 저장 데이터 결정론 파생 폴백(counselorBaseline=학습자 턴 rapport_signal 누적 이동평균, clientValence=deep 값 우선/client_state 극성+appropriateness 결합 폴백), 2점 미만 빈 배열·10점 초과 균등 리샘플·축 라벨 4개, hidden_turns 시 비산출로 프라이버시 계약 유지. dev-login 재승인은 현행 유지로 종결. 검증: 각 과제 RED 관측→GREEN(에이전트별 증거 로그), 백엔드 pytest 421 passed(신규 test_review_valence.py 9 포함), gateway 29, typecheck/build/design-ssot/dead-code/duplication(0.03%) 통과, focused 무회귀 44/42/40/20/14, professor·persona 레이아웃 게이트 통과, 감정 차트는 실DB 공감 5턴 세션에서 baseline·client 각 5포인트/축 4라벨 라이브 실측. 전 스위트 재완주 수치는 체크리스트 문서 §0에 기록. 부수 관찰: smoke-resistance-openness-db.py의 advice_jump turn_client_state ≥5 단언이 엔진 변동성에 민감(결함 로그 #23, 코드 회귀 아님). 체크리스트 415항목 미체크 0 도달. 배포(2026-07-27): commit 4511383c로 커밋 후 Cloudflare Pages production d8ebcb61 배포 — 커스텀 도메인이 index-Dqr2stZ-.js 서빙, prod API 8001은 start-public-runtime.ps1로 새 코드 재기동, 공개 헬스·auth config(dev login disabled)·비인증 401·OAuth 302·watchdog 전체 healthy 실측.

145차 적용(2026-07-27): 142·144차가 소유자 결정 대기로 남겨둔 시각 언어·구조 항목 11건을 질문 도구로 전건 결정받아 구현하고, 새로 만든 브레이크포인트 스윕이 "기존 결함"으로 관용하던 시각 붕괴까지 없앴다(8+2 병렬 구현 에이전트, 파일 그룹 분할로 충돌 0). 결정·구현: ① Kicker accent dot = "밀집 화면만 정리" — 기본값 dot=true는 유지하고 상태를 전달하지 않는 장식만 dot={false}. 회기 진행 화면 7→2(진행 상태·안전 점검만 유지), /learn 0, /teach 0(화면에 남은 점은 <Dot tone> 실제 상태 컴포넌트). ② 영문 대문자 eyebrow 한글화SPEND CONTROL→예산 관리, RUNTIME ROUTE→엔진 경로, DAILY JOURNAL→일별 기록, SESSION/SUPERVISOR→회기/지도. MODEL LEDGER·EVALUATOR CACHE·METERING INTEGRITY는 번역 대신 제목과 중복이라 삭제 → 화면상 영문 대문자 eyebrow 0개. 영문 전용 트래킹(letter-spacing:0.12em, 10px)도 한글 판독에 맞게 정리. ③ 가운뎃점 라인당 1개 — 페르소나 제목·세션바·메타 줄을 어절 단위로 분리(splitPersonaTitle/splitMetaLines), 나열형은 쉼표로 낮춤. ④ eyebrow 중복 제거 — 바로 아래(또는 위) 제목과 같은 말인 것만 삭제, 새 정보를 주는 것은 유지. ⑤ 빈 상태 중립화/teach/analysis 345행×5열의 "평가 부족/변화 부족/라포 부족/기법 부족" 반복을 -로 바꾸고 설명은 열 머리에서 한 번만, 셀에는 title로 보조. ⑥ 탭 구분 강화 — 비활성 탭이 배경과 같아 탭으로 안 보이던 학습 대시보드·회기 리뷰에 구분선. ⑦ 비용 표시 정밀도 — 합계는 소수 2자리($41.4887$41.49), 단가는 4자리($0.101439$0.1014), 원본은 title에 보존, 차트 라벨 9px→11px. ⑧ 기본 테마 OS 추종readInitialTheme()이 저장값 → prefers-color-scheme → dark 폴백 순으로 바뀌었다(§8.C 위반 해소). ⑨ Pretendard self-host — jsDelivr 렌더 블로킹 스타일시트와 preconnect를 없애고 public/fonts/PretendardVariable.woff2(2,057,688 B) + @font-face + preload로 전환. ⑩ 프리스타트 정보 중복 제거 — 호소·대상·난도가 아바타 카드와 본문에 두 번 나오던 것을 본문만 남김. ⑪ 브레이크포인트 스윕을 E2E 스펙으로 편입e2e/breakpoint-sweep.spec.ts(797줄)가 CSS에서 @media 폭을 자동 추출해 페이지별 B-1/B/B+1을 돌고 겹침·잘림·붕괴·화면밖·문서오버플로를 검사한다. 오탐 4종(line-clamp, visually-hidden, 원형 마스크, 폰트메트릭 1~2px)은 구조적으로 제외하고, 실제 결함 3건을 되살려 잡히는지 증명하는 테스트를 포함해 검출력 없는 게이트가 되지 않게 했다. 결정의 후속으로 깨진 것들: ⑧ 때문에 layout-visual-gategateScreen()이 전면 실패했다(1 failed·14 미실행). 이 스펙은 "다크 시작 → 라이트 토글 → 다크 복귀" 흐름이라 프로젝트 colorScheme:dark로 풀면 라이트 토글 테스트가 깨진다. beforeEach에서 vignette.theme="dark"를 심어 게이트가 자기 전제를 명시하게 고쳤다. ⑦③ 때문에 옛 카피를 박아둔 단언 3건($6.6212, 페르소나 옵션 접근이름, 설정 임상·회기·말투)이 stale이 돼 앱이 아니라 테스트를 갱신했다. AdminAi.tsxremaining_usd(number|null) 무가드 전달로 빌드가 깨져 있던 것도 수정했다. 스윕이 관용하던 결함 제거: 새 스펙의 KNOWN_APP_DEFECTS에 있던 3건을 실제로 고쳐 배열을 비웠다(재발 시 즉시 실패). ㉮ /learn/practice 1181~1360px에서 프리뷰 제목이 글자 단위로 쪼개져 흘러내리던 것(서연/(가/명)·/고2/우울//자살사/고) — .lh-preview__hero의 2열 트랙 max가 auto라 액션 열이 280px까지 먼저 자라고 제목 열이 47px만 남은 게 원인. flex 전환 + flex:1 1 340px로 최소 폭 확보, overflow-wrap:anywherebreak-word. 제목 열 47px→343px. ㉯ 세션 카드 본문이 67px로 뭉개지던 것 — 같은 뷰포트에서도 카드 폭이 391/431/794px로 달라 @media로는 못 잡아 저장소 최초로 @container를 도입해 카드 폭 기준으로 접었다. 본문 67→211px. ㉰ 리캡 아바타가 320px에서 48px 잘리던 것 — 인라인 style={{width:196}}이 암시적 트랙을 부풀린 게 원인, minmax(0,1fr)+min-width:0+aspect-ratio:1로 해소. 검증: typecheck·check:design-ssot 통과, raw color 예산 전부 이내(learner-home 21/25 · session 215/216 · session-review 29/29 · login 10/11), breakpoint-sweep 7/7(관용 목록을 비운 뒤 재실행도 7/7), layout-visual-gate 15/15, learner+teacher+session-layout 44/44, admin·learner·teacher 66/66. 폰트 self-host는 cdn.jsdelivr.net 요청 0건·document.fonts.check() true·woff2 200으로, 테마 기본값은 localStorage 빈 컨텍스트에서 light/dark 양방향으로 실증했다. 주의: session-review.css raw color가 29/29로 여유 0이라 하나만 더 넣어도 게이트가 깨진다. .lh-recap__avatar .vg-avatar__stage에 이 파일 최초의 !important가 들어갔다(ClientAvatar가 높이를 인라인으로 박아 다른 수단이 없음. 컴포넌트가 size를 CSS 변수로 노출하면 제거 가능). @container는 저장소 최초 사용이라 구형 브라우저에서는 수정 전 동작으로 폴백된다. 미결(소유자 결정): /learn 메트릭 카드는 여전히 "평가 부족"을 쓴다(⑤가 /teach/analysis로 스코프됨), persona-studio 사용 현황 표는 ≤760px에서 뒤 2개 지표를 숨기는 기존 설계를 유지했다. 로컬 작업트리 기준이며 배포 전이다.

144차 적용(2026-07-27): 브레이크포인트 경계 전수 스윕. 142차 접근성 감사가 1440·390 두 폭만 봤고 기존 layout-visual-gate도 7개 폭(390/720/861/900/1024/1280/1440)만 검사한다는 소유자 지적에서 출발했다. CSS 전체에서 고유 width 브레이크포인트 25개(340~1420)를 추출해 파일→페이지로 매핑하고, 페이지마다 자기에게 영향을 주는 브레이크포인트의 B-1 / B / B+1 과 실기기 대표 폭을 조합해(페이지당 17~36폭 × 높이 2종) 순회하며 요소 겹침 · 텍스트 잘림 · 폭 붕괴 · 화면 밖 이탈 · 문서 오버플로를 계산으로 검출했다. 1차 스윕에서 156개 문제 뷰포트 / 11종 결함이 나왔다. 수정한 결함: ① 설정 서브네비 라벨 전면 소멸(721~1080px 전 구간) — 공용 @media (max-width:1080px).vg-set__rail{display:grid; grid-template-columns:minmax(220px,280px) minmax(0,1fr)}body[data-page="settings"]까지 덮어써 244px 레일 안이 다시 2열로 쪼개졌고 둘째 트랙이 0px로 붕괴, nav 폭 0 · nav-item 28px · 라벨 span 7개(계정/AI 운영/지원 요청/동의/테마/알림/음성) 폭 0이 됐다. 721~980px 는 별개로 .vg-set__nav-item span{display:none}이 라벨을 통째로 숨기고 있었다. 721~1080px 를 상단 가로 탭으로 통일해 라벨을 항상 노출한다. ② 세션 프리스타트 목표 fieldset 겹침(전 폭 72뷰포트) — .sx-prestart__notemargin-top:-12px 음수 마진이 앞 형제 fieldset.sx-goals 마지막 줄을 88x12px 파고들었다. ③ 프리스타트 dd·desc 세로 잘림-webkit-line-clamp:2가 좁은 폭에서 문장을 잘라먹던 것을 해제하고, 데스크톱 한 화면 제약은 max-height + overflow-y:auto로 대체. ④ 프리스타트 우측 "진행 초점" 패널 195px 잘림(1041~1240px, 200개 폭) — 3열 minmax(220px,…) minmax(360px,…) minmax(260px,…)는 최소 888px를 요구하는데 이 구간의 실제 컨테이너는 735~886px뿐이라 트랙이 축소되지 못하고 우측 패널이 통째로 잘렸다. overflow-x:hidden이라 스크롤도 안 되고 문서 오버플로는 0이라 기존 "contained" 게이트가 구조적으로 못 잡던 유형이다. 트랙 최소치를 0으로 낮추고 2열 전환점을 1040→1260px로 올려 이중 안전망을 뒀다. ⑤ 티켓 필터 "초기화" 버튼 화면 밖 이탈(1180~1257px) — 7트랙 grid가 최소 954px를 요구하는데 셸 사이드바를 뺀 컨테이너가 876~950px라 마지막 트랙이 밀려났다. 4트랙 2줄로 낮추고 유연 트랙 최소치를 0으로. ⑥ 페르소나 이름 세로 잘림(320px) — 이름 칸이 150.6px뿐이라 3줄이 필요한데 line-clamp:2에 걸려 3번째 줄이 사라졌다. ≤420px 밴드에서 3줄 허용. 오탐으로 판정해 고치지 않은 것: .aic-ledger b·.lh-metric-card b의 2px 세로 초과는 line-height가 Pretendard content-area(ascent+descent≈1.09em)보다 작아 생기는 폰트메트릭 아티팩트다. overflow hidden/visible 6x DPR 캡처를 20개 폭에서 바이트 비교해 pixelDiff=0(잘린 픽셀 0)을 확인했고, 1180/1280px에서는 같은 렌더링인데 반올림 방향만 바뀌어 탐지에서 빠지는 것도 증거다. .vg-set__voice-info .vd(의도된 line-clamp:2)와 .vg-set__skel-sr(visually-hidden), .vg-avatar__stage(border-radius:50% 원형 마스크)도 오탐이다. 2차 스윕으로 1차가 못 본 사각지대(높이 브레이크포인트 620/820 경계, 탭 전환 등 인터랙션 후 상태, 와이드 폭 1600~2560, 초협소 320)를 14개 라우트에서 추가 순회했고 새 결함 0. 결과: 진짜 결함 0(잔여 66뷰포트는 위 오탐 3종). 검증: typecheck · check:design-ssot 통과, session.css raw color 216/216 유지, layout-visual-gate 15/15, session-layout+session-mvp+learner+settings 56/56, 앞선 병렬 수리 검증에서 session-layout+settings+admin 55/55. 미결(소유자 결정): 프리스타트에서 호소·대상 정보가 .sx-prestart__case(좌측 아바타 카드)와 .sx-prestart__facts(본문)에 중복 렌더된다(3열·2열 양쪽 모두, 이번 변경과 무관한 기존 IA 문제). 로컬 작업트리 기준이며 배포 전이다.

143차 적용(2026-07-27): 전 페이지·버튼 단위 전수 E2E 순회 캠페인. IA 전 라우트(로그인/온보딩/승인대기/학습자 3뷰·세션·리뷰/교수자 콘솔·분석·페르소나/관리자 5섹션/설정/아바타 랩)의 기능 412개를 소스 기준 인벤토리로 만들어 docs/ops/e2e-full-sweep-2026-07-27.md 체크리스트 백로그(- [ ]/- [x])로 관리하고, RED→GREEN으로 결함을 수정했다. 신규 스펙 10파일 e2e/full-sweep-*.spec.ts(수집 424의 절반가량)를 추가했고, 소유자 결정 대기 항목은 test.fixme + 백로그 B3-신규 6건으로 분리했다. 수정한 결함(RED 재현→GREEN): ① /admin/ai 부트 watchdog 오탐 오버레이(index.html 셀렉터에 .aic 추가), ② 한국어 PII 마스킹이 "유의점은·방치되는·마무리했을" 같은 일반 단어를 [NAME]으로 치환해 평가 문장을 훼손하던 과잉 마스킹(guardrail 꼬리 글자 가드), ③ 온보딩 연락처 무검증(서버 pydantic 검증+클라이언트 안내), ④ 리뷰 요약 조사 오류("하늘와의"→받침 인식 와/과)와 난도 원문 노출(easy→기초), ⑤ /pending 새로고침 무피드백+아이콘 오용(refresh 아이콘 신설), ⑥ 학습 대시보드 탭 패널 aria-label 고정, ⑦ 회기 종료 다이얼로그 반말 문체, ⑧ 설정 스크롤 스파이 마지막 섹션 미활성(0 임계값+밴드 최하단 규칙+바닥 폴백), ⑨ 모바일 세션 겹침 2건(타임바 :has 4행 템플릿, 코치 넛지 플로우 배치), ⑩ 관리자 콘솔 무한 렌더 루프 프리즈(TanStack autoResetPageIndex↔setState — users/services 메모화+autoResetPageIndex:false, 결정적 재현 스펙 2건을 회귀 가드로 유지), ⑪ 복수 코호트 조용한 유실(POST/PATCH /admin/users가 cohort_ids 첫 항목만 저장 → 콤마 직렬화+알림 SQL 배열 겹침 비교), ⑫ 공개 페르소나 보관 전면 불능(DELETE /personas/{id}가 실DB에서 항상 503 — archive_persona_family UPDATE…FROM RETURNING의 무한정 code 모호성 → card. 한정, 실API RED 503→GREEN archived 실측). 마무리 탐색 순회(실브라우저 6에이전트, 68항목)는 67 GREEN·감정 밸런스 차트 데이터 소스 미구현(서버가 항상 빈 배열 — 사문 렌더 경로, 로드맵 기록) 1건을 추가로 확인. 검증: 백엔드 pytest 412 passed(신규 회귀 테스트 8개 포함), gateway 29 passed, typecheck/build/check:api-types/design-ssot/dead-code/duplication(0.03%) 통과, layout-visual-gate 15/15, session-layout 8/8, 최종 npm run e2e 재완주 — 병렬 424 수집 그린(fixme 4·모바일 의도 숨김 2 스킵), 직렬 49/49 passed(14.4m), exit 0. 열린 항목: B3-신규 6건(설정 아바타 변경/동의 철회·재동의 흐름/첫 추천 난도/분석 페이지네이션/저작 레일 잔존 마크업/dev-login 재승인 정책), 공개 OAuth 스모크는 기존 B2 유지. 로컬 작업트리 기준이며 배포 전이다.

142차 적용(2026-07-27): design-taste-frontend 스킬의 보편 규칙(§4.5 대비 검사, §6.B/6.C 모션·다크모드, §9.F/9.G AI tell)을 기준으로 전 20개 라우트를 3역할·라이트/다크·데스크톱/모바일 54개 조합으로 순회 감사하고 결함을 수정했다. 감사는 눈대중이 아니라 페이지마다 WCAG 대비비를 계산하는 Playwright 스크립트로 측정했다. (A) 라이트 팔레트 AA 미달--ink-3(캡션·메타)가 모든 라이트 표면에서 2.7~3.1:1, --neutral-400(placeholder)이 2.4:1이었다. 색조를 유지한 채 #6a6c65/#6f6e68로 낮추고 위계 유지를 위해 --ink-2#4d514b로 조정했다(강도 13.9 · 본문 6.9 · 캡션 4.6:1). 다크는 --ink-3 #979a8f, --neutral-400 #949b8f. (B) 다크 토큰 이중 진실원본 — 다크 블록이 --text-muted 등을 var(--ink-3) 별칭 대신 값으로 하드코딩해 primitive 수정이 다크에 반영되지 않았다. 라이트와 동일하게 별칭으로 통일했다. (C) 채움색을 글자색으로 전용--accent는 채움 기준값이라 어두운 표면 위 본문 크기에서 4.3:1이다. --text-accent(= --accent-deep) 별칭을 신설해 kicker·secondary 버튼·역할 라벨 등 텍스트 용도를 옮겼다. (D) 로그인 안내 배너 1.19:1.lg-config가 다크 패널 전제(반투명 갈색 + 밝은 앰버)라 라이트에서 사실상 읽을 수 없었다. 테마별로 스왑되는 warn 의미 토큰으로 교체(5.3:1). (E) 미정의 CSS 변수 12종--text-dim·--good-solid·--border-faint·--fs-xl 등이 정의 없이 참조돼 색/배경이 조용히 무효화되고 있었고, learner-home--bg-inset/--border-soft 폴백은 다크 전제 값이 라이트 페이지에 적용되고 있었다. 전부 기존 의미 토큰으로 매핑했다. (F) 학습자 분석 테이블 컬럼 침범.pf-learner-row__id의 암시적 그리드 트랙이 자식의 width:max-content를 수용해 261px 셀이 288px로 늘어나 max-width:100%가 무력화됐고, 긴 이름 28행이 옆 컬럼을 27px 침범했다. minmax(0,1fr)로 고정해 0건. (G) 한글 조판word-break 기본값 때문에 "오전"이 "오/전", "검토 대기"가 "검/토 대기"로 쪼개졌다(5건). 세션 화면이 쓰던 keep-all + overflow-wrap:break-word를 전역으로 올려 0건. (H) 탭 타깃 — WCAG 2.2 SC 2.5.8(24px) 기준으로 약관 동의 라벨 19px→28px, 학습자 이름 버튼 19px→25px, 설정 range 슬라이더 16px→24px(투명 테두리 + background-clip:content-box로 시각 크기는 유지). (I) LCP — 렌더 블로킹 CDN 폰트에 preconnect/dns-prefetch 추가(Pretendard self-host는 별도 과제). 결과: 54개 조합 전부 대비 위반 0 · 탭 타깃 위반 0 · 라벨/alt 누락 0 · 가로 오버플로 0(감사 전: 대비 2,043건, 탭 타깃 355건). 검증: npm run typecheck, check:design-ssot 통과, layout-visual-gate 15/15, session-layout 8/8, auth-visual·teacher·admin·session-review·settings·learner 포함 E2E 87 passed + 14 passed. 미결(소유자 결정 필요): kicker의 accent dot이 기본 true라 회기 화면 한 곳에 11개 이상 찍히는 점(§9.F는 장식 dot 0을 요구, 다만 DESIGN_CONCEPT가 명시한 강조 장치라 임의 변경하지 않음), 영문 대문자 eyebrow(SPEND CONTROL·RUNTIME ROUTE·DAILY JOURNAL·SESSION·SUPERVISOR)의 한글화, 섹션당 eyebrow 밀도(§4.7은 섹션 3개당 1개), 중점(·) 라인당 다중 사용(/teach 33행), prefers-color-scheme 무시하고 다크 고정인 기본 테마(§8.C), 관리자 AI 비용 표시 정밀도($37.6560·$0.102885). 로컬 작업트리 기준이며 배포 전이다.

141차 적용(2026-07-15): 공통 Surface inset는 중첩 카드처럼 보이던 border와 radius를 제거하고 반투명 광원·blur만 유지한다. 관리자 사용자 목록은 사용자별 article grid와 겹치던 ad-user__meta를 제거하고 @tanstack/react-table 기반 semantic table로 전환했다. 사용자/역할/관리 권한/승인 상태/소속/코호트/활성 회기/최근 접속/작업 열을 고정하고, 헤더 클릭 정렬과 sticky header, 1440px 최소 폭을 제공한다. 좁은 화면에서는 문서가 넓어지지 않고 표 region만 가로 스크롤된다. 검증: typecheck, 관리자 사용자 생성·승인·편집·비활성화 및 모바일 스크롤 focused E2E 4/4, layout visual gate 15/15. 로컬 작업트리 기준이며 배포 전이다.

136차 적용(2026-07-15): 135차의 학습 대시보드 한정 보태니컬 스타일을 전 페이지 공통 디자인 시스템으로 승격했다. AppShell은 역할·라우트와 무관하게 단일 vg-shell--botanical 크롬을 사용하며, 과거 관리자·교수자·대시보드 전용 톱바/GNB override를 삭제했다. GNB는 라이트/다크 고해상도 투명 원본(846×1858, 922×1706)을 사용하고 이미지 시작점을 메뉴 아래로 내려 텍스트 침범을 막는다. 데스크톱 GNB는 shell body 안에서 top:0, 모바일 drawer에서만 top:var(--topbar-h)를 사용해 상단 빈 공간을 없앴다. 공통 캔버스는 우상단 보태니컬 배경과 같은 이미지를 180° 회전한 좌하단 배경을 함께 사용하며, main은 투명하게 둔다. 표면은 셸 SSOT에서 큰 패널용 glass와 내부 행·필드·요약용 inset glass 두 단계로 통합해 학습자·교수자·관리자·설정·페르소나·회기 리뷰·진행 세션의 모바일 재배치까지 같은 반투명 그라데이션, 저채도 황금 hairline, blur/saturation을 사용한다. 로그인·온보딩·승인대기도 같은 글래스 패널을 쓴다. 라이트 테마는 흰 카드와 흰 캔버스가 겹쳐 유리 효과가 사라지던 토큰을 수정해, 반투명 본체+스페큘러 광원 2층, 안쪽 굴절선, 샴페인 hairline과 세이지/골드 캔버스 광원을 사용한다. 모바일에서도 보태니컬 캔버스를 제거하지 않는다. 학습 대시보드의 오늘의 회기/기록 · 리뷰/성장 지표 탭과 회기 리뷰의 축어록/피드백/워크시트 탭은 모든 폭에서 유지한다. Live2D 주변의 이중 외곽 컨테이너는 제거하고 투명 clipping 영역에서 캐릭터·잎 장식만 우하단으로 잘리게 했다. object-separate --check로 로컬 GPU 분리 런타임을 확인했고, 제공 원본이 정상 RGBA alpha(0–255)라 재분리 없이 원본을 사용했다. 검증: npm run typecheck, npm run build, layout-visual-gate 15/15, learner/session-layout/session-review desktop+mobile 46/46, 라이트·다크·관리자·교수자·설정·리뷰·진행 세션 1440px 및 390px 스크린샷 직접 확인. 로컬 작업트리 기준이며 배포 전이다.

135차 적용(2026-07-15): 제공된 Vignette-Asset-Set의 512px 최적화 PNG 14종을 public/design-elements/learner-dashboard/로 자산화하고 학습 대시보드(/learn)에만 보태니컬 시안을 적용했다. 라이트/다크 각각의 사이드바·우상단 배경과 메트릭 카드 4종·AI 코치 장식을 테마별로 교체하며, 카드 표면은 크림/차콜의 비대칭 광원 그라데이션과 저채도 황금 헤어라인을 사용한다. 이 범위 제한은 136차에서 전 페이지 공통 글래스 시스템으로 대체됐다. layout-visual-gate는 라이트 테마 자산 연결까지 computed style로 확인하고 테마를 다크로 복귀한다. 검증: npm run typecheck, npm run build, layout-visual-gate 12/12, session-layout 8/8, learner desktop/mobile 14/14, 라이트·다크 1440px 및 다크 390px 스크린샷 직접 확인. 로컬 작업트리 기준이며 배포 전이다.

135차 적용(2026-07-15): 소유자 후속 결정으로 회기 리뷰 탭을 중간 폭 한정에서 전 폭 공통으로 확장 완성했다. 소유자가 SessionReview.tsx·e2e에 남긴 방향(탭 바 전 폭 노출, "기존 데스크톱 3컬럼은 시선 이동과 빈 공간이 커서 사용하지 않는다")에 맞춰, 데스크톱에서도 축어록/피드백/워크시트 중 활성 탭 하나만 전폭 단일 컬럼으로 보여주도록 CSS를 정리했다 — 파일 끝의 '전 폭 탭' 블록을 단일 진실로 삼고 앞부분의 구 3컬럼·중간폭 전용 규칙과 중복 정의를 제거(같은 셀렉터의 후행 전역 규칙이 탭별 컬럼 규칙을 덮던 충돌 해소). 피드백 탭은 인사이트 흐름 위 / 평가·검토 레일 아래 세로 스택. e2e는 전 폭 탭 계약으로 갱신: session-review.spec 영역 헬퍼(활성 탭 단일 컬럼 + 인사이트→평가 세로 순서 + 밴드가 그리드 위), teacher.spec·session-persistence.spec(워크시트/프리포스트/검토 카드 단언 전 해당 탭 오픈 — '평가 대기' 대기 자리표시자 포함), layout gate는 소유자 갱신본(전 폭 columnCount 1 계약) 그대로 통과. 검증: typecheck, 브라우저 실측(데스크톱 2005px·좁은 폭 603px 탭 전환/스택/무오버플로), session-review+teacher+session-mvp 64/64, layout gate 12/12, persistence worksheet·prepost @single-run 2/2, 로컬 프로젝트 전체 재실행 그린(동시 실행 플레이크 2건은 단독 재실행 통과). 부수: voice consent-withdrawal e2e가 공유 learner 계정 데이터를 파기하는 특성 확인 — 로컬 수동 점검 시 계정 온보딩 재완료 필요(terms_accepted/privacy_accepted 포함). 로컬 작업트리 기준이며 배포 전이다.

140차 적용(2026-07-15): /teach/personas를 기존 3열 저작 스튜디오에서 상단 horizontal tab 기반 워크스페이스로 재구성했다. 1차 탭은 대시보드 / 카탈로그 / 페르소나, 페르소나 내부 2차 탭은 전체 페르소나 / 검수 현황이다. 대시보드는 공개·활성 페르소나, 실제 학습 인원·진행/종료 세션, 저장된 상담자 턴 평가와 라포 신호만 집계한 성과·진척도, 검수 요약 및 페르소나별 최근 기록을 표시한다. 카탈로그는 승인본 공개·보관·버전 규칙과 이론 분포를 설명한다. 전체 목록은 검색/구분 필터가 있는 table로 시스템(P1~P11)/사용자 생성, 공개·검수·초안 상태, 버전과 행 작업을 한 번에 보여준다. 행 상세는 소개·학습 현황·설정 탭 drilldown이며, 신규/수정은 자료→초안→설정→검토 4단계 작업면과 이전/다음 이동, 브라우저+서버 중간 저장을 사용한다. 모바일 table은 가로 밀림 대신 카드형 행으로 재배치한다. 기존 RAG·draft·검수·승인·archive API 계약은 유지했다. 부수로 기존 동시 작업의 LearnerHome.tsx 중복 className 컴파일 오류를 동일 interactive surface 호출로 병합했다. 검증: npm run typecheck, npm run build, 페르소나 focused E2E 6/6, 새 IA·작성 step focused 2/2, layout visual gate 14/14, session-layout desktop/mobile 8/8, 1440px·390px 대시보드/상세/작성 캡처 직접 확인. 로컬 작업트리 기준이며 배포 전이다.

139차 적용(2026-07-15): 앱 셸을 뷰포트 높이의 고정 프레임으로 바꿔 톱바와 GNB는 화면에 남고 vg-main만 독립적으로 세로 스크롤하게 했다. 문서 전체 위에 절대 위치로 떠 있던 좌하단 보태니컬 vg-shell__body::after 레이어는 제거하고, GNB 장식은 vg-nav 자체 배경에만 유지했다. 모바일 가로 GNB도 같은 프레임의 첫 행에 고정된다. learner layout gate는 메인 scrollTop 변화, GNB 위치 변화 1px 이하, window scroll 불변을 390~1440px에서 확인한다. 검증: layout visual gate 13/13, session layout desktop/mobile 8/8. 전체 npm run typecheck/build는 동시 작업 중인 PersonaStudio.tsx 미사용 선언 오류로 차단됐으며 이번 셸 변경과 무관하다. 로컬 작업트리 기준이며 배포 전이다.

138차 적용(2026-07-15): 학습 대시보드 메트릭 카드의 장식 이미지는 카드별 --lh-art-right/--lh-art-bottom/--lh-art-width/--lh-art-height 변수로 크롭을 독립 조정하는 현행 구조를 유지했다. 회기 리캡 아바타 뒤의 잎 장식은 인물 식별을 흐려 제거하고, lh-session-focus 패널 우측 하단으로 이동해 right:-20px, bottom:-28px에서 보더에 걸려 잘리게 했다. 검증: npm run typecheck, npm run build, learner home layout visual gate 1/1(390~1440px 7개 폭 + 1200px 라이트/다크), 1200px 라이트·다크 캡처 직접 확인. 로컬 작업트리 기준이며 배포 전이다.

137차 적용(2026-07-15): 회기 시작 전 화면의 sx-prestart 고정 1120px 폭을 제거해 sx-head와 같은 가용 폭을 사용하고, 내담자·설정·진행 초점 3열을 비율형으로 재조정했다. 진행 초점은 고정 문구 3개 대신 현재 단계, 선택 이론의 실제 대화 기준, 선택 목표, 회기 시간·알림·안전 원칙을 반영하는 동적 브리핑으로 확장했다. layout visual gate에 전 폭 헤더/준비 카드 폭 일치와 브리핑 항목 회귀를 추가했다. 검증: npm run typecheck, npm run build, session prestart layout visual gate 1/1(390~1440px 7개 폭), 1440px·1024px 캡처 직접 확인. 로컬 작업트리 기준이며 배포 전이다.

134차 적용(2026-07-15): 소유자 실사용 피드백 3건과 그 과정에서 드러난 회귀·결함을 일괄 처리했다. (A) 중간 폭 가로 탭 전환 — 1158px 실측 피드백("2컬럼 굳이 필요한가, 상단 horizontal tab이 낫지 않나" + "사례 워크시트까지 탭에")에 따라 SessionReview는 ≤1180px에서 3컬럼 대신 상단 가로 탭(축어록/피드백/워크시트)으로 영역을 전환한다(.sr-tabs + .sr-cols--tab-*, 데스크톱 3컬럼 무변경). 같은 패턴으로 학습 대시보드(/learn)도 ≤1180px에서 오늘의 회기/기록 · 리뷰/성장 지표 탭으로 재구성했다(.lh-tabs + .lh-grid--tab-*, 메트릭 카드·헤더는 탭 밖 상시 노출). e2e는 탭 인식 헬퍼로 갱신(session-review 모바일 supervisor 계열 5건 포함). (B) 관리자 배경 rect 제거/admin 우측 상단의 이상한 밝은 사각형은 .ad-root::beforeclinical-paper-ambient.png(560×420, opacity 0.045)를 다크 배경 위에 깔던 장식으로, 이미지 경계가 rect로 드러나던 것 — 규칙 자체를 제거했다. (C) 회귀·결함 수정 — ① 신규 회기 시작 직후 URL 전환이 resume 재로딩을 트리거해 서버 스냅샷(0턴)이 전송 직후의 낙관적 학습자 발화를 덮어쓰던 race를 justStartedSessionRef 가드로 수정(@single-run SSE persistence 재현·해결). 같은 가드로 신규 회기 초기 코칭 이력 동기화는 수행하되 stale quota가 기본 기회 수를 덮지 않게 applyQuota:false로 결정론화(이전에는 재로딩 race 승패에 의존). ② 모바일(≤880px) 코칭 카드에서 근거 보기/이력 보기 버튼을 숨기던 규칙 제거 — 근거 감사 접근은 코칭 신뢰성의 핵심이라 모바일에서도 유지(공간 절약은 발화 예시 blockquote 숨김까지만). ③ 안전 결함: 모바일 압축 레이아웃이 위기 신호 시에도 안전 패널(109 리소스 포함)을 통째로 숨기던 문제를 sx-has-safety 페이지 클래스 + 위기 시 노출 규칙(≤1180/≤880 양쪽)으로 수정. ④ 세션 프리플라이트(목표 선택 포함)가 데스크톱에서 문서 스크롤을 6~13px 넘치던 회귀를 .vg-main:has(.sx-page--prestart) 패딩 축소로 수정, 모바일은 세로 스크롤 허용으로 e2e 계약 조정. ⑤ e2e 드리프트 정리: 학습 현황 라벨(aria-label) 정합, readiness CTA 단언 갱신, dev 엔진 음성 턴 실측(90초+)에 맞춘 voice persistence 타임아웃 상향(150s/240s). 검증: npm run typecheck, 로컬 프로젝트 전체 164 passed(desktop+mobile), layout-visual-gate 12/12, 실엔진 @single-run 직렬 전체 44 passed(20.8분 — race·타임아웃 수정 반영 후 전 그린), 브라우저 실측(learn 탭 3종 전환·데스크톱 1440 회귀·admin rect 소멸 스크린샷). 로컬 작업트리 기준이며 배포 전이다.

133차 적용(2026-07-15): 두 갈래를 일괄 처리했다. (A) 회기 리뷰 화면 재설계 — 소유자 피드백(도킹된 리뷰 요약 레일이 스크롤을 따라다니며 콘텐츠를 가림 + 3컬럼 빈 공간 과다 + 세로 나열 요약 카드)에 따라 SessionReview 레이아웃을 재구성했다. 리뷰 요약은 sticky 제거 후 상단 전폭 밴드(요약 문장 + 팩트 칩 3개 가로 + 액션 버튼 가로)로 승격, 본문은 행 높이 공유로 데드 갭을 만들던 grid-areas 행 배치 대신 컬럼별 자체 흐름 스택(.sr-left/.sr-right 래퍼 grid)으로 바꿔 좌 인사이트 / 중앙 축어록(주역) / 우 평가 스택 구조를 만들었고, 워크시트는 전폭 하단으로 내렸다. 사이드 레일 대기 자리표시자는 컴팩트 스타일로 축소. e2e 기하 계약(session-review.spec 헬퍼·layout-visual-gate 학습자 워크벤치)은 새 설계 기준(밴드가 그리드 위, 3컬럼 chart→transcript→rubric 순서)으로 갱신했다. 검증: session-review.spec.ts 24/24, layout gate 12/12, typecheck/build. (B) 연구팀 태깅 축어록 4종 활용 — 첫회기 BPS·게슈탈트 3회기·자해 DBT·우울 CBT 태깅 엑셀을 실명 사전 치환 후 신규 POST /personas/sources/upload로 KB 등록(101청크 색인·임베딩, hash-only 증거, 원본 미저장). taxonomy.py v1.1.0 — 연구팀 태그 정합으로 Technique 9종·ClientState 9종 append-only 추가(docs/taxonomy.md 조작적 정의 동반). 가드레일 _MEANS_TERMS 자해 도구·방법 확장(경계 설정 표현 오차단 방지 테스트 포함). 라이브 코칭 소스팩 3종 신설·색인(DBT 위기·전념 / 게슈탈트 무브 / 부모 첫회기 무브, 17청크). 등록 근거로 RAG 페르소나 초안 4종 생성·저장 — P8 미영(45세 부모측·통합/CBT), P9 유진(자해 DBT·hard·게이티드 — 초안 warnings에 '교수 검수·안전장치 테스트 전 활성화 금지' 명시), P10 선혜(게슈탈트 한부모), P11 정호(Beck CBT 비자발 남성). 전부 draft 상태로 교수 검수 큐 노출 — 승인·활성화는 연구팀 몫(월권 방지). 부수 수정: 게이트웨이 /v1/generate 턴 타임아웃 120s 하드코딩 → ENGINE_GENERATE_TIMEOUT_SECONDS(기본 300s)로 설정화(대형 구조화 생성 대응). 실행 기록·임상팀 게이트 후속은 ops/tagged-data-utilization-2026-07-15.md. 검증: 백엔드 pytest 396 passed, 게이트웨이 29 passed, typecheck/build. 로컬 작업트리 기준이며 배포 전이다.

132차 적용(2026-07-15): 회기 목표 선택 상한을 1~2개 → 1~4개로 확장했다(소유자 지시). 백엔드 goal_stages 검증 max_length=4+중복 제거, 프론트 토글은 교체 로직 없이 자유 토글, 준비 화면 문구 1~4개 선택. 회의 스펙(2개 수준)과의 차이는 소유자 결정으로 기록한다. 검증: 백엔드 pytest 394 passed(목표 계약 테스트 4개 갱신), typecheck, 브라우저에서 4개 선택→시작→목표 배지 4개 확인.

131차 적용(2026-07-14): 2026-07-13 한신대 회의 결정(P1~P5)과 소유자 추가 지시(코칭 고도화·수치 상세·포탈·다크모드 채도·UI 컬랩싱)를 일괄 구현했다. P1 시간 기반 회기 — 세션은 60분(SESSION_DURATION_MINUTES) 기준으로 진행하고 종료 10분 전 앰버 알람 바, 시간 만료 시 정리 유도 다이얼로그 강제 오픈, 유예(+10분) 이후 신규 턴은 서버가 409 session_time_over로 거부한다(텍스트/음성 공용). 시작 전 준비 화면에서 이번 회기 목표 단계를 1~2개 선택하는 goal_stages 계약을 추가했고(app.sessions.session_goals JSONB + 런타임 스키마 가드 + readiness probe 갱신), 목표를 달성해도 시간 내에는 계속 진행한다(목표 달성 넛지만 표시). P2 누적 게이지·수치 상세 — 설계 1p ops/session-progress-gauge-design-2026-07-14.mdbuild_session_progress() 순수 파생으로 단계별 누적 게이지(라포 임계 대비 %, 회기 간 ×0.7 이월로 누적)와 방어(저항)/유효 개방도/라포 누적+이번 회기 증가분 %를 세션 트랙·관찰 신호 패널·상세 응답·스트림 done·대시보드 페르소나 카드에 노출했다. 코칭 고도화 — 미동작 원인 3중(기본 ambient 모드에서 호출 자체 차단 / 미커밋 audit 강등이 dev 무DB에서 정상 LLM 응답 폐기 / 3중 AND 충전 조건으로 사실상 충전 불가)을 근원 수정: 코칭 탭이 닫혀 있으면 기회를 소모하지 않고 컨텍스추얼 넛지 칩으로 대기시키고, record_llm_call_audit는 dev 폴백(무DB)을 기록 실패로 보지 않으며, 충전은 완화된 성과 조건 + 6턴 페이싱 충전으로 재설계했다. 프롬프트에 회기 목표·직전 코칭을 주입하고 폴백도 단계별 문장으로 개선했다. P4 업로드 — 자유 양식 엑셀 경로가 없어 신규 구축: POST /personas/sources/upload(xlsx/csv→텍스트 결정론 변환, 원본 바이트 미저장·hash-only 증거) + PersonaStudio 파일 첨부. 파란 라벨 샘플 실업로드로 NAME 마스킹·chunk 색인·임베딩·raw hash-only를 확인했다. P3 부하scripts/load-test-sessions.py로 20 동시 세션 생성 20/20(p95 125ms, RAG warm 병목 없음), 5 동시 실턴 p50 55s로 claude_cli 상주 풀 병목 실측 → 파일럿 전 ENGINE_MODE=claude_api 전환 권고. 이관 초안 ops/server-migration-runbook-draft.md, 파일럿 지침 ops/pilot-usage-guide-draft.md, 협업 가이드 guides/collaboration-for-researchers.md. 포탈 — 학습자 대시보드에 보완할 부분(평가 파생 약점 신호)·내담자별 라포 누적 게이지·연습 이정표(기존 미노출 achievements)를 추가하고 중간 폭(1181~1420px) 리캡 카드 붕괴를 수정했다. 다크모드 채도 완화 — imagegen2 시안 3종(docs/design/darkmode-2026-07-14/) 중 A(따뜻한 차콜+마른 세이지 #7da294대)를 채택해 tokens.css 다크 블록과 session/shell/login/settings/learner-home/session-review CSS의 하드코딩 고채도 틸을 일괄 저채도로 치환했다(라이트 모드 무변경). 컬랩싱 — 세션 화면 내담자 컨텍스트·안전 점검 패널 기본 접힘 + 위기 신호 시 안전 점검 강제 오픈, 관찰 신호 접기 토글. 검증: 백엔드 pytest 393 passed(신규 시간/목표 9종·게이지 7종·엑셀 변환 9종·코칭 충전 4종 포함), npm run typecheck/generate:api-types, session-layout.spec.ts 8/8, layout-visual-gate.spec.ts 12/12, 실브라우저 E2E(1분 회기 알람→만료→409, 코칭 넛지→실LLM 코칭 카드 3→2, 2회기 carry 65%→46%=×0.7 정확, 대시보드 실데이터). 회의 스펙의 '정리 발화 시 자동 종료'는 백엔드에 원래 존재하지 않는 것으로 실측 확인 — 수동 조기 종료 경로가 이를 대체하며 스펙 문서와의 차이는 이 노트가 기록한다. 로컬 작업트리 기준이며 배포 전이다.

20차 적용(2026-06-28): 신규 Google/SAML 사용자는 account_status=pending으로 시작하고 승인 전에는 /pending 안내 화면만 본다. yunchan@twentyoz.kr는 슈퍼 관리자 allowlist로 admin+approved를 받으며, /admin/users는 가입 승인 탭에서 pending 계정을 승인 또는 보류 처리한다.

21차 적용(2026-06-28): 관리자 페이지 진입권을 기본 역할과 분리해 app_user.admin_access로 저장한다. AUTH_SUPER_ADMIN_EMAILS 기본값은 yunchan@twentyoz.kr, hoonjungkoo@hs.ac.kr이며, 슈퍼 관리자는 학습자·교수자·관리자 공간 전환과 관리자 권한 부여/회수를 할 수 있다. 학생·교수 계정도 admin_access=true면 우측 상단 관리자 진입이 노출된다. 구성 슈퍼 관리자의 권한 회수와 계정 비활성화는 차단한다.

25차 적용(2026-06-28): /admin/users에서 허용 도메인 밖 이메일도 정확한 계정 단위로 강제 등록할 수 있다. Google/SAML/dev-login은 미리 등록된 이메일만 도메인 게이트 예외로 통과시키고, provider 로그인 시 기존 관리 row의 역할·코호트·승인 상태를 이어받는다. 미등록 외부 도메인 로그인은 계속 차단한다.

10차 적용(2026-06-27): 학습자 영역을 /learn 대시보드, /learn/practice 연습 대상, /learn/history 기록으로 분리했다. 홈은 최근/진행 회기를 기준으로 Live2D 아바타·감정 힌트·마지막 내담자 반응·학습자 마지막 발화·AI 코치 문장을 보여주는 세션 리캡 중심 대시보드로 바꾸고, 새 회기 시작은 학습 탭으로 낮췄다.

11차 적용(2026-06-27): 현재 /learn 화면을 다시 캡처한 뒤 UX 원칙(사용자 필요, progressive disclosure, 정보 향, adaptive layout)을 기준으로 이미지 생성 시안 3장을 만들었다. UI 지침에는 11-learner-dashboard-redesign-concept-b.png, 12-learner-dashboard-redesign-concept-b-alt.png만 채택하고, 상담실 배경으로 나온 10-learner-dashboard-redesign-concept-a.png는 폐기했다. 구현은 회기 리캡과 AI 코치/이어하기 CTA를 홈 첫 블록으로 묶고, 독립 다음 행동 카드는 제거했다.

16차 적용(2026-06-28): 생성 시안과 더 맞추기 위해 /learn 하단을 리뷰 대기, 다음 연습 추천, 최근 기록 3분할 카드로 재배치했다. AI 코치 패널에서는 진행/리뷰 카운트와 보조 링크를 제거하고, 코칭 문장·3개 체크 힌트·단일 이어하기 CTA만 남겼다. 최신 검증 캡처는 docs/design-verification/learner-home-redesign/final-*.png다.

18차 적용(2026-06-28): /learn/history는 표형 기존 회기 목록을 제거하고 전체, 진행 중, 리뷰 필요, 보관됨 상태 필터와 검색, 카드형 회기 기록 작업대로 재구성했다. 설계 지침은 docs/archive/design-concepts/prompts/learner-history-archive-redesign-2026-06-28.md, 검증 캡처는 docs/design-verification/learner-history-redesign/history-*.png다.

22차 적용(2026-06-28): 회기 아카이브를 실제 저장 상태로 연결했다. 학습자 종료 회기는 POST /sessions/{id}/archive/restore로 보관·복원하고, app.session_archive_state는 삭제가 아니라 학습자별 보기 상태만 저장한다. 회기·턴·리뷰·공유 링크·연구/감사 증거는 유지하며, 보관된 회기는 /learn/history보관됨 필터와 dashboard archived_sessions에 반영되고 리뷰 대기 행동 큐에서는 제외된다.

24차 적용(2026-06-28): 운영 콘솔 /admin/usage의 DB 집계 쿼리에서 ORDER BY tokens_in + tokens_out가 PostgreSQL 원본 컬럼 참조로 해석되어 prod에서 503 fail-closed 되던 문제를 수정했다. provider/model별 정렬은 SUM(tokens_in)+SUM(tokens_out) 집계식 기준으로 바꿨고, public API 프로세스의 실제 HTTP smoke는 source=database, durable=true로 200을 반환한다.

23차 적용(2026-06-28): app.persona_voice_map을 실제 /voice/ws TTS voice 선택에 연결했다. 명시 query preset이 최우선이고, 없으면 세션의 persona_id/persona_version 또는 dev persona catalog의 voice map을 읽으며, unsupported provider는 기존 persona-code fallback으로 fail-safe 처리한다. seed materializer는 기본 OpenAI voice map row를 ON CONFLICT DO NOTHING으로 생성하고, dev 런타임 스키마 보강은 기존 DB의 persona_voice_map 누락도 함께 복구한다.

12차 적용(2026-06-27): 회기 리뷰 데스크톱 레이아웃은 sticky 요약 레일을 유지하되 트랜스크립트가 같은 컬럼을 공유하지 않도록 재배치했다. 왼쪽 요약 문장은 보조 브리핑 밀도로 낮추고, 축어록은 중앙 근거 작업대에 고정해 스크롤 중 레일이 발화 내용을 가리지 않게 했다.

13차 적용(2026-06-27): 회기 리뷰의 적절한 개입 등 평가 콜아웃은 제한 markdown을 기본 렌더링한다. effective_opennesseffective openness(유효 개방도)로 학술 용어화하고, 상담자 질문 발화는 ReviewNote.quote 인용 블록으로 분리해 카드 내부에서 시각화한다.

14차 적용(2026-06-27): 활성 상담 세션은 시작 직후 실제 session_id URL로 고정해 새로고침 후에도 같은 회기 상세를 복원한다. 전역 topbar는 몰입형 화면에서 계속 숨기되, 내부 세션바에 기록으로/학습 홈 이동을 추가했다. 종료된 세션 상세도 곧바로 리뷰로 밀어내지 않고 읽기 전용 기록 화면에 머물며, 리뷰 이동은 명시 버튼으로만 수행한다.

15차 적용(2026-06-28): 학습자·교수자·운영·페르소나 스튜디오 화면을 같은 작업형 폭 정책으로 정렬했다. 교수 콘솔은 검토 대기·위기 알림·페르소나 검수·저작실 순서가 DOM과 화면 모두 일치하고, 페르소나 스튜디오는 SSOT 첨부/RAG 생성/항목 편집/검증 큐가 한 작업면에서 이어지는 구조로 유지한다. 적용 리포트와 대표 캡처는 docs/archive/ops/layout-research-2026-06-28/dashboard-layout-alignment-report.md에 남겼다.

146차 적용(2026-07-28): 공개 /login에서 직전 배포 엔트리 index-FVj73yvV.js가 이미 삭제된 lazy 청크 Login-BMWWhZXH.js를 요청해 화면 진단으로 떨어진 배포 전환 결함을 실증·복구했다. 새 chunkRecovery는 Vite vite:preloadError를 받아 경로별로 문서를 정확히 한 번만 다시 받고, 정상 라우트 커밋 뒤 잠금을 해제한다. 연속 실패는 무한 새로고침하지 않고 ErrorBoundary로 보내며 진단 화면에 최신 버전 다시 불러오기·홈으로 이동 액션을 제공한다. Cloudflare Pages production e7d40ffa는 격리 작업공간에서 base commit facc4ad2+이번 3파일 수정만 빌드했고, 새 엔트리 index-BBHxK-uX.js와 함께 운영 직전 두 세대(index-Dqr2stZ-.js/Login-DQyYRTcl.js, index-FVj73yvV.js/Login-BMWWhZXH.js) 자산을 실제 JavaScript로 보존했다. 검증: typecheck·build 통과, 개발 서버 재로드 잠금 focused 1/1, 프로덕션 preview 청크 첫 요청 강제 실패 1/1, 공개 도메인 동일 강제 실패 1/1, 공개 로그인 버튼 2개 enabled·브라우저 오류 0, API health/auth config 200.

147차 적용(2026-07-30): 재부팅·엔진 readiness 지연이 관리자 페이지 미노출로 전파되던 운영 결함을 분리했다. 기존 부팅/워치독은 db=true여도 engine=false면 전체 런타임을 실패로 보고 API·웹·터널까지 재시작할 수 있었고, 브라우저의 최초 /auth/me에는 timeout이 없어 불러오는 중…에 오래 머물 수 있었다. 이제 제어면 readiness는 environment=prod + db=true, 엔진 readiness는 별도 게이트다. 엔진 단독 장애 시 살아 있는 API·웹·cloudflared는 유지하고 엔진만 복구하며, 브라우저는 요청별 5초 상한·3회 재시도 후 같은 HttpOnly 세션으로 다시 연결하는 명시 화면을 낸다. 401만 로그아웃으로 확정한다. 실증: role admin·super-admin·delegated admin 각각 관리자 5경로 렌더, 인증 503 3회 뒤 재연결 2 focused passed, desktop/mobile 관리자 20 passed, typecheck·build, 백엔드 admin/auth 48 passed, PowerShell 5.1 parser 3파일 오류 0, 엔진 상태 검사 중 API PID 36824 유지, watchdog healthy, 예약 작업 LastTaskResult=0, failcount 0. Cloudflare Pages production 564dbed9는 새 엔트리 index-Cwtfyfq5.js와 직전 3세대 lazy 자산을 함께 게시했다. 공개 청크 강제 실패 1 passed, 공개 임시 관리자 세션으로 5개 관리자 경로·사이드바·브라우저 오류 0을 확인하고 세션을 즉시 삭제했다. 마지막 강제 엔진 readiness도 실제 응답 OK로 통과해 공개 /healthstatus=ok, db=true, engine=true로 회복됐다.

148차 적용(2026-07-30): 캐시·청크가 아니라 실제 슈퍼 관리자 계정의 durable entitlement와 cross-role navigation을 다시 추적했다. 운영 DB에서 primary role이 learner인 슈퍼 관리자 계정의 admin_access=false와 활성 learner 세션을 확인했고, 공개 /auth/me는 설정 기반으로 super_admin/admin_access=true를 계산했지만 기본 역할 사이드바에는 관리자 진입점이 없어 학습자 작업면으로 이동하면 운영 페이지가 UI에서 사라지는 silent path가 있었다. 이제 설정 기반 슈퍼 관리자/관리자 entitlement는 로그인·세션 복원 때 app.app_user.admin_access=true로 영속화하고, learner/teacher 사이드바에도 권한이 있으면 운영 콘솔을 표시한다. 실운영 계정 두 active session은 유지한 채 durable 접근권을 즉시 고정했고 API만 PID 15280으로 교체했다. 실증: backend auth/admin 49 passed, typecheck/build, PowerShell 5.1 parser 0 errors, admin·super-admin·delegated admin 5경로 및 cross-role 복귀 desktop/mobile 4 passed. Cloudflare Pages production 1332ccbe는 격리 빌드 엔트리 index-D4Twx0A1.js와 직전 3개 배포 자산을 보존했다. 실제 Google 슈퍼 관리자 사용자 행에 연결한 임시 세션으로 공개 관리자 5경로, learner 화면의 운영 콘솔 링크, restored-tab 복원을 4 passed로 확인했고 임시 세션은 DELETE 1로 제거했다. 최종 public API는 status=ok, environment=prod, db=true, engine=true다.

149차 적용(2026-07-30): 148차의 관리자 접근권 영속화 배포 직후 신규 Google OAuth 콜백이 managed user persistence unavailable; runtime fallback is disabled in prod 503으로 실패한 회귀를 긴급 수정했다. 원인은 이메일 기반 기존 사용자와 OAuth external id를 연결하는 선행 UPDATE에서 nullable 관리자 플래그 $7의 PostgreSQL 타입을 명시하지 않아, 실제 쿼리가 AmbiguousParameterError: could not determine data type of parameter $7로 prepare 단계에서 실패한 것이었다. 선행 UPDATE와 본 upsert의 관리자 플래그를 모두 ::boolean으로 고정하고, non-dev 저장 실패는 원래 예외를 서버 로그에 남기게 했다. 실증: 운영 DB rollback 트랜잭션에서 수정 전 오류를 재현, 수정 후 실제 Google 사용자 행의 upsert_managed_user()가 learner·admin_access=true·approved로 통과, auth/admin backend 50 passed와 py_compile 통과. API만 PID 40992로 재시작했고 local/public health는 prod·db=true·engine=true다. 같은 실제 사용자 행으로 새 브라우저 세션을 생성해 공개 /auth/me 200, email 일치, learner, admin_access=true, super_admin=true, approved를 확인한 뒤 임시 세션을 즉시 폐기했다.

150차 적용(2026-07-30): 사용자가 계속 보고한 “서버/API는 200인데 관리자 본문 픽셀이 비는” 현상을 실제 렌더 기준으로 다시 추적했다. 관리자 셸의 실제 세로 스크롤 소유자는 document가 아니라 .vg-main(overflow-y:auto)인데, 129·147차 수정과 E2E는 window.scrollY만 조작해 잘못된 대상을 검증하고 있었다. 테스트를 .vg-main.scrollTop=900으로 바꾸자 긴 관리자 페이지→권한 페이지 이동과 restored pageshow 모두 900이 남아 RED가 됐고, 실패 픽셀에서도 제목·상단 상태·KPI가 화면 위로 사라진 것이 확인됐다. AppShell이 mount·pathname 변경·pageshow마다 내부 스크롤을 직접 0으로 복원하도록 고쳤고, 관리자 blank probe와 HTML boot watchdog은 실제 .vg-main viewport와 교차하지 않는 DOM을 visible node로 세지 않게 했다. 실증: 정확한 RED 2 failed → GREEN 2 passed, 관리자 복원·5경로 desktop/mobile 8 passed, typecheck/build 통과. 격리 Cloudflare Pages production f323a41dindex-Dun9umCY.js/AppShell-B-RAIuNL.js/Admin-CGJKO18P.js를 서빙하고 직전 4세대 자산을 보존한다. 실제 Google 슈퍼 관리자 사용자 행의 15분 임시 세션으로 공개 관리자 5경로, learner→운영 콘솔 복귀, 내부 scrollTop 900의 restored-tab을 4 passed로 확인하고 공개 관리자 홈 픽셀 캡처에서 제목·상태·KPI·내비·본문을 직접 확인한 뒤 세션을 폐기했다.

151차 적용(2026-07-30): 실제 사용자 캡처와 같은 “셸·내비·관리자 API 200은 남지만 본문만 완전히 비는” 화면을 공식 EasyList 일반 cosmetic rule로 재현해 원인을 확정했다. 관리자 DOM/CSS 접두사 ad-*.ad-root.ad-section이 EasyList 광고 숨김 목록에 정확히 포함되어 uBlock Origin·AdGuard·Brave 계열 차단기가 운영 콘솔 전체를 광고로 오인했다. 같은 두 selector에 display:none!important를 주입한 RED가 사용자 캡처와 같은 픽셀을 만들었고, API 상태와 무관하게 heading이 숨겨졌다. 관리자 클래스 487곳을 광고 의미가 없는 vgops-* 전용 namespace로 교체하고, 루트/진단은 중립 data-vignette-admin-* marker를 쓴다. HTML watchdog도 관리자 selector 존재 여부가 아니라 marker의 실제 rect/computed visibility를 판정하므로 이후 외부 CSS가 화면을 숨기면 React root 밖 진단을 띄운다. 로컬 실증: EasyList RED 1 failed → GREEN 1 passed, admin route guards 12/12, admin full-sweep 20/20, admin 7폭 layout focus 3/3, session-layout desktop/mobile 8/8, typecheck 통과. 배포·공개 실증: 격리 Cloudflare Pages production 0a339b77index-PqLVP802.js/Admin-DQbkd1Xc.js/Admin-CUeOG5q6.css를 서빙하고 최근 4세대 엔트리를 보존한다. 실제 Google 슈퍼 관리자 사용자 행의 임시 세션에서 같은 EasyList 규칙을 켠 채 관리자 5경로가 모두 visible, legacy ad-* class 0, boot/admin diagnostic 0, 브라우저 오류 0임을 픽셀 캡처로 확인하고 세션을 즉시 폐기했다. 공개 health는 prod·db=true·engine=true다.

152차 적용(2026-07-30): 동일 장애가 사람의 naming 주의에만 의존해 다시 들어오지 않도록 release gate로 승격했다. check-cosmetic-filter-safety.mjs는 프로덕션 TS/TSX/CSS와 index.html 81개를 매 빌드마다 검사하고 ad-*·ads-*·advert*·sponsor* class/id가 있으면 배포 번들 생성을 중단한다. 탐지기 자체도 위험 fixture는 반드시 잡고 vgops-root·upload-card·head-faceless 같은 안전 식별자는 허용하는 자체 검사를 매번 먼저 통과해야 한다. 이 gate를 npm run buildnpm run lint 앞단에 연결해 public runtime 시작 경로도 우회할 수 없게 했다. 로컬 EasyList E2E는 규칙 주입 후 첫 HTML watchdog 판정까지 기다린 뒤 root/heading 실제 가시성·legacy class 0·진단 0을 검사하고, 공개 스펙은 같은 규칙을 첫 paint부터 적용한 관리자 5경로 검증을 소유한다. 검증·배포: detector self-test 통과, production source 81개 통과, typecheck/build 통과, 강화된 로컬 EasyList 회귀 1/1 통과. gate를 실제 통과한 격리 빌드를 Cloudflare Pages production 1b3b6d5b로 다시 게시했다. custom/preview 모두 index-PqLVP802.js를 서빙하고 공개 Admin-DQbkd1Xc.js는 격리 산출물과 SHA-256 일치, vgops-root 존재, ad-root 부재다. 직전 4세대 엔트리는 모두 JavaScript 200이며 공개 health는 prod·db=true·engine=true다.

153차 적용(2026-07-30): 관리자 AI 엔진 설정을 자유 문자열 입력에서 게이트웨이 capability 기반 선택으로 바꿨다. claude_cli·claude_api·codex_cli·agy_cli·openai·solar 6종을 같은 계약으로 관리하고, GET /v1/capabilitiesGET /admin/engine-capabilities가 설치·인증 상태, 사용 가능 모델, 모델별 추론 강도, 기본값을 전달한다. 관리자 콘솔과 설정은 provider·모델·추론 강도를 드롭다운으로 제한하며 Codex 기본은 gpt-5.6-terra / medium, Agy 기본은 gemini-3.6-flash-high / high다. 연결 주소를 바꾸면 이전 주소의 catalog를 즉시 폐기하고, 편집 중인 새 URL을 engine_url query로 넘겨 목록을 다시 확인하기 전에는 저장할 수 없다. PATCH도 제안된 게이트웨이의 capability를 다시 확인해 연결 불가·존재하지 않는 모델·지원하지 않는 강도를 422로 막고 durable 설정을 보존한다. 기존에는 engine_mode가 사실상 설정 표시값에 가까웠으나 이제 generate/stream/readiness가 실제 provider 실행기로 라우팅되며 reasoning_effort도 DB·API·게이트웨이까지 영속된다. Codex app-server model/list에서 실제 모델을 조회하고 Terra/Medium 생성 응답 OK, Agy models에서 실제 모델을 조회하고 Gemini 3.6 Flash/High 생성 응답 VIGNETTE_ISOLATED_OK를 격리 작업 디렉터리에서 실측했다. Anthropic API는 현재 키가 없어 의도대로 선택 불가이며 live 동일성은 B2에 남긴다. 임시 신규 게이트웨이/API 연결에서는 Codex·Agy 선택 저장과 Claude CLI 원복을 확인했고, backend 전체 466 passed, web build, 관리자 AI desktop/mobile 1+1, admin AI 전수 7, settings 레이아웃·모바일 3이 통과했다. 현재 로컬 9099도 신규 게이트웨이 코드로 구동되어 Codex 7개 / Terra / medium, Agy 11개 / Gemini 3.6 Flash High / high live catalog를 반환하고, 로컬 API의 관리자 capability 라우트는 미인증 요청을 401로 차단한다. 121차의 “고장 URL을 저장해 실패 row 생성” E2E는 새 fail-closed 계약과 충돌해 저장 거부·기존 설정 보존 증거로 대체했고, 평가 재시도 UI 회귀는 route fixture spec이 계속 소유한다. 현재 상태: 로컬 작업트리·게이트웨이 검증 완료, 공개 웹 배포 전이다.

154차 적용(2026-07-30): 153차 AI 엔진 capability 변경을 공개 런타임까지 반영했다. API PID 11788과 gateway PID 44488를 신규 코드로 교체하고 Cloudflare Pages production 2f52f8e3-f992-441f-ada4-f6396cbb1a2b를 게시했다. 최종 custom domain은 index-B54GMBSf.jsAdminAi-ClAJvCvx.jsapplication/javascript 200으로 제공한다. 최초 production a3819e6e 검증에서 5세대 전 엔트리 index-Cwtfyfq5.js의 보존 누락을 발견했기 때문에, scripts/preserve-pages-assets.ps1가 최근 production preview의 HTML·JS·CSS 의존 그래프를 재귀적으로 수집하고 MIME을 검사해 현재 dist에 병합하도록 고친 뒤 최종 배포로 교체했다. custom domain에서 현재와 이전 4세대 엔트리가 모두 JavaScript 200이며, lazy 청크 첫 요청 강제 실패도 문서 재로드 1회 뒤 1/1 복구됐다. 실제 Google 슈퍼 관리자 사용자 행에 연결한 15분 임시 세션으로 공개 /admin/ai에서 공급자 6개, Codex 7개 / gpt-5.6-terra / medium, Agy 11개 / gemini-3.6-flash-high / high를 확인했고 저장 없이 세션을 즉시 삭제했다. 공개 health는 status=ok, environment=prod, db=true, engine=true이며 auth config 200, 비인증 personas·admin capability 401, watchdog LastTaskResult=0다. 153차의 공개 배포 전 상태 표기는 이 증거로 대체한다.

155차 적용(2026-07-31): 세션 텍스트 입력이 AI 생성·TTS 종료까지 잠기고 답변 표시 뒤에도 evaluator가 끝날 때까지 다음 전송이 약 24초 묶이던 학습 UX를 실제 브라우저와 gateway/API 계량으로 분해했다. textarea는 회기 종료·일시정지에서만 잠기며 생성·음성 준비·재생 중에는 다음 질문 초안을 계속 작성·보존하고, 내담자 응답 저장 직후에는 음성 재생과 무관하게 다음 전송을 허용한다. 관리자 DB의 Agy/Gemini 설정은 evaluator/review에 유지하되 실시간 client 역할은 VIGNETTE_LIVE_CLIENT_PROVIDER=claude_cli 전용 lane으로 분리해 회기별 claude -p 프로세스를 재사용한다. stream learner/client turn과 결정론 상태를 먼저 durable 저장하고 SSE done을 보낸 뒤 fast-loop 평가는 백그라운드에서 같은 learner turn normalized row에 붙이며 평가 기반 코칭 충전도 한 번만 적용한다. Agy fallback도 stream-json delta를 실제 SSE token으로 전달한다. 로컬 음성은 -UseHiggsVoice로 설치된 higgs-audio-v3-tts-4b를 loopback 상주시켜 P1 실제 답변을 24kHz WAV로 합성하며 저장소의 무참조 synthetic seed만 reference로 허용하고 non-dev는 fail-closed한다. 실증: 변경 전 full API 완료 24.17/24.57초, 변경 후 실제 UI 첫 응답·전송 해제 9.58초와 상주 연속 턴 6.96초, 생성 중 초안 enabled/보존, TTS 중 보내기 enabled. Higgs full API 362,924 bytes/7.56초 WAV, provider/model 헤더 확인. backend 432/432, gateway 44/44, typecheck·API types·build, session stream 1/1, voice skip/draft 1/1 통과. 배포·공개 실증: commit c7883434를 origin/master에 push하고 Cloudflare Pages production 505155c4-01f3-4eac-ad59-c2d323a0bb51로 게시했다. custom/preview 모두 index-BU5JjRnR.js를 JavaScript 200으로 서빙하고 최근 5개 배포의 의존 자산을 보존한다. 공개 API는 prod·db=true·engine=true, auth config Google configured/dev login disabled, 비인증 personas·voice speech 401, Google 시작 302다. 실제 공개 로그인 1280×720 렌더에서 버튼 2개 enabled, 브라우저 warning/error 0을 확인했다. 공개 음성은 라이선스 경계상 openai / gpt-4o-mini-tts를 유지한다.

156차 적용(2026-07-31): 활성 상담 세션이 전역 테마와 무관하게 .sx-page--active에서 다크 팔레트를 다시 정의해, 라이트 설정에서도 화면은 다크인데 공통 Surface inset인 AI 코치만 밝게 뜨는 혼합 테마 결함을 수정했다. 세션 전용 --bg-surface/--text-*/--accent 덮어쓰기를 제거하고 전역 data-theme·tokens.css·공통 Surface를 그대로 사용해 라이트는 종이·글래스, 다크는 차콜·세이지로 함께 전환한다. 우측 레일은 AI 코치 → 현재 신호 → 음성·AI 응답 상태 순으로 재배치하고 의미 없는 equalizer 막대와 중복 화면 모드 행을 제거했다. 700px 이하 높이에서는 발화 예시·보조 흐름을 먼저 접고 코치 판단과 근거/이력 액션을 보존하며, 기존 사각지대였던 881~1180px에서도 코칭 모드에 AI 코치 카드만 전폭으로 남긴다. 검증: npm run check:design-ssot, typecheck, build 통과, 세션 전수 desktop/mobile 30 passed / 2 skipped, session-layout 8/8, 7폭 layout-visual-gate 15/15, 라이트 1366×640 코치·1024×640 압축 코치 및 다크 1440/1024/390 캡처 직접 확인. 로컬 작업트리 기준이며 배포 전이다.

157차 적용(2026-07-31): 사용자 제공 1536×1024 활성 세션 시안을 실제 세션 화면에 반영했다. 데스크톱을 좌측 단일 컨텍스트 레일 326px / 중앙 인물 무대+자막 / 우측 단일 라이브 코칭 레일 357px / 하단 116px 제어바로 재구성하고, 상태 신호 모드에서도 AI 코치의 개입 시점·남은 기회·코칭 포인트를 미리 이해할 수 있게 했다. 제공된 수채화 잎 5장은 BEN2로 투명 분리한 뒤 600×800 이하 알파 WebP로 최적화해 합계 약 158KB로 줄였고, 좌우 캔버스와 아바타 뒤에 장식 계층으로 연결했다. 새 E2E는 1408px 상단/본문, 1468px 제어바, 326/357px 레일, WebP 응답과 computed background 연결을 1536×1024에서 고정한다. 1366×768 이하에서는 스테이지를 압축해 자막이 주 작업영역을 잃지 않게 했다. 검증: npm run check:design-ssot, typecheck, build 통과, 세션 전수 desktop/mobile 32 passed / 2 skipped, session-layout 8/8, 7폭 layout-visual-gate 15/15, 1536×1024 라이트 캡처 직접 확인. 앱 commit 12bdc594를 Cloudflare Pages production에 배포하고 배포 증거 commit 32c0b97d를 연동한 최종 production f9b06388까지 완료했다. 커스텀 도메인의 index-CzevzoM7.js, Session-BWMFTqgE.js, Session-D7DZVnh0.css, leaf-1.webp가 각각 올바른 JavaScript/CSS/WebP MIME으로 200을 반환했다. 공개 로그인 실렌더·브라우저 warning/error 0, API prod/db/engine=true, 비로그인 personas 401, Google OAuth 시작 302, watchdog 5항목 healthy도 확인했다.

158차 적용(2026-07-31): 관리자 Provider·모델별 사용 원장에서 Claude CLI만 비용이 잡히고 Agy/Gemini가 0달러로 보이던 원인을 수정했다. Claude CLI는 SDK가 반환한 호출별 비용 추정값을 우선하고, 비용이 없는 Agy/Gemini·Codex·Claude API는 버전 고정 공식 참조단가로 입력·캐시 입력·출력 토큰을 환산한다. 기존 DB에 비용 0으로 저장된 행도 /admin/usage 조회 시 보정하며, 공식 단가가 등록되지 않은 모델은 0달러 대신 미산정으로 표시한다. 응답과 리포트는 recorded_cost_usd, estimated_cost_usd, cost_basis, 단가 라벨·출처를 분리한다. 공개 DB-backed 30일 원장에서 gemini-3.6-flash-high 5호출·입력 35,703·출력 1,129가 $0.062022로 보정되고 총비용에도 합산되는 것을 인증 요청으로 확인했다. 검증: backend/gateway focused 66 passed, API type generation/check, typecheck, build, 관리자 desktop/mobile focused E2E 2 passed, 7폭 focused layout visual gate 1 passed. 공개 API 프로세스를 재시작하고 Cloudflare Pages production 11b3e11f에 배포했으며, 커스텀 도메인의 AdminAi-BfxMUlzj.jsAdminAi-XHkda_d4.css가 올바른 MIME으로 200을 반환한다.

159차 적용(2026-07-31): Claude CLI result에 실제 usage/modelUsage가 있는데도 게이트웨이의 generate·SSE done 응답이 tokens_in=0, tokens_out=0을 하드코딩해 DB 원장에 0을 저장하던 근본 원인을 수정했다. modelUsage/model_usage가 있으면 메인 호출과 서브에이전트를 모델별로 합산하고, 없을 때 최상위 usage로 폴백한다. 입력 원장은 비캐시 입력 + cache read + cache creation 합계다. 과거 미수집 행은 토큰을 비용으로 역산하지 않고 token_unmetered_turns로 분리해 화면에 미계량으로 표시하며, Claude total_cost_usd는 청구 실비가 아니라 SDK 추정치이므로 provider_estimate/SDK 추정으로 바로잡았다. 검증: backend 전체 436 passed, gateway 전체 45 passed, API type generation/check, typecheck, build, 관리자 desktop/mobile 2 passed, 7폭 focused layout gate 1 passed. 신규 live Opus generate는 입력 31,918·출력 4·비용 추정 $0.124862, Haiku SSE done은 입력 30,450·출력 159·비용 추정 $0.061685를 반환했다. 운영 DB 30일 원장의 과거 Claude 194건은 token_unmetered_turns=194, cost_basis=provider_estimate로 확인했다. 공개 런타임을 새 gateway/API로 교체하고 Cloudflare Pages production 10c2bfc3에 배포했다. 커스텀 도메인의 index-BDlbUpT7.js, AdminAi-r9AkYKAl.js, AdminAi-D7JtoYC_.css는 올바른 MIME으로 200이며, 실제 관리자 임시 세션의 공개 브라우저에서 미계량·SDK 추정·토큰 커버리지와 Codex/Agy catalog를 확인하고 세션·storage state를 즉시 폐기했다.

160차 적용(2026-07-31): 159차 이전 Claude 토큰 0/0 행을 비용에서 역산하지 않고 실제 로컬 Claude 실행 JSONL로 제한 백필했다. JSONL 3,908개의 assistant usage record 3,848개를 본문 출력 없이 읽고, 정규화 응답 SHA-256과 DB 생성 시각 창(-30초~+180초)이 모두 맞으며 후보가 정확히 1개인 경우만 허용했다. 운영 전체 Claude 442건 중 169건을 실제 입력 5,179,999·출력 46,910 토큰으로 복구했고, 후보 없음 273건은 계속 미계량, 모호한 후보는 0건이다. apply는 --expected-matches 169와 행별 UPDATE 1 가드를 통과했으며 적용 후 dry-run의 추가 exact match는 0건이다. 확인 시점 30일 창은 Claude 183건 중 계량 125·미계량 58건이었다. 검증: backend 전체 439 passed, gateway 전체 45 passed, 공개 관리자 브라우저 1 passed에서 Claude 실제 토큰과 부분 계량 125/183회, 잔여 미계량 설명, 브라우저 오류 0을 확인하고 임시 인증 세션·storage state를 폐기했다. DB-only 백필이므로 추가 웹 배포 없이 공개 UI가 live API 결과를 즉시 반영한다.

161차 적용(2026-08-06): Outcome & Alliance OS G1 Alliance Core를 증거 게이트로 닫았다. 수련생 자기평가를 먼저 append-only로 잠근 뒤 가상내담자와 독립 관찰자를 별도 모델 실행·세션으로 평가하며, 공개 전에는 외부 관점을 숨기고 terminal 상태에서만 3관점 × goal/task/bond 9개 축을 함께 보여준다. 교수자 재평정은 근거 장면·메모를 강제하고 이전 평정을 supersede하는 append-only 원장으로 남긴다. 학습자 리뷰는 축별 총점 없이 관점 차이·근거 장면·provenance를 데스크톱 표와 모바일 카드로 제공한다. 검증: focused backend 40 passed, 실 PostgreSQL RLS·상태전이·재시도 model-run·교수자 supersession smoke, Alliance Pulse desktop/mobile 6/6와 기존 회기 리뷰 12/12. prompt 1.2.0 합성 gold는 방향 정확도 9/9, 최종 실패 0, 근거 recall 88.9%이며 실패한 첫 시도 2건도 provenance로 보존됐다. G2 종단 성과 궤적을 병렬 구현 중이다.

162차 적용(2026-08-06): Outcome & Alliance OS G2 Longitudinal Outcome Trajectory를 증거 게이트로 닫고 G3를 BUILD로 승격했다. 교육용 합성 5회기 기대분포와 고통 부담·일상 기능·학습 참여 세 축을 총점 없이 추적하며, 누락은 무점수, safety는 별도 참조, 관계 합의·미해결 균열은 역할별 문장으로 분리한다. 학습자 리뷰에는 1~5회기 타임라인, 축별 상태·불확실성·근거·반대근거·다음 질문과 최신 회기 자기보고 체크인을 연결했다. 검증: 4-case×5-session benchmark status 정확도 1.0, false alert·critical miss 0; 실제 DB/API 한 case S1~S5·15개 관측, 동일 제출 멱등성, 변경 payload 409, 학습자 소유권·교수자 cohort·교차 cohort 차단, role-safe 관계 기억 통과. G2 desktop/mobile 12/12, G1+기존 리뷰 15/15, G2/G3 통합 backend 90 passed다.

163차 적용(2026-08-06): Outcome & Alliance OS G3 Rupture & Repair Lab을 증거 게이트로 닫고 G4를 BUILD로 승격했다. 9종 파열 상태머신·append-only 관측/재조정/안전참조 원장, 텍스트·SSE·음성 공통 durable-turn 감지, 후속 발화의 missed/partial/resolved reconciliation, 역할별 리뷰·교수자 supersession, 4~6턴 희소 Scenario Director와 prompt/SSE 내부 라벨 누출 차단을 연결했다. 검증: 11-case benchmark 유형 macro-F1 1.0, 복구 상태 정확도 1.0, critical miss·judge gaming·암기문구 false resolution 0; Scenario/G3 집중 107 passed, G0~G8 통합 계약 251 passed, 리뷰 desktop/mobile 50/50. 실제 DB/API 회기에서 durable turn UUID 2개, 내부 토큰 write, 멱등 retry/변조 409, learner/cohort RLS, 교수자 append-only correction과 최종 resolved를 확인했다.

164차 적용(2026-08-06): Outcome & Alliance OS G4 Deliberate Practice Engine을 증거 게이트로 닫고 G5를 BUILD로 승격했다. 평가 장면을 관찰 가능한 원자 행동과 replay·branch·constrained response·voice retry·difficulty ladder 5종 prescription으로 연결하고, competency graph의 약점·망각 위험에 따라 다음 연습을 고른다. 익숙한 장면 반복이나 자기 성공 주장만으로 mastery를 열지 않고 미지 사례 전이를 요구한다. 검증: G4 core/store/API 54 passed, G4 리뷰 desktop/mobile 8/8, G1~G4+기존 리뷰 58/58. 실제 DB/API 회기에서 durable turn 근거 처방→학습자 시도→교수자 append-only correction, 안정 멱등 retry/변조 409, learner/cohort RLS, 보상 해킹 차단, 총점·XP 없음과 비임상 경계를 확인했다.

165차 적용(2026-08-06): Outcome & Alliance OS G5 Calibration Mirror & Transfer를 증거 게이트로 닫고 G6를 BUILD로 승격했다. 외부평가 전 prediction revision과 불가역 lock, 독립 runtime observation reveal, 역량별 calibration error·95% 구간·과신/과소신 처방, 네 변주 축 unseen transfer와 암기 문구 차단, 합성 subgroup drift를 역할 안전 원장/UI에 연결했다. 검증: G5 core/store/API 41 passed, 4-case expectation accuracy 1.0, 보정 MAE 0.667→0.267, unseen transfer 4/4, 암기 false verification 0, drift gap 0.667. 실제 DB/API revision→lock→reveal·멱등/변조 409·post-lock 422·RLS, G5 UI 4/4와 G1~G5 리뷰 62/62, typecheck/build를 통과했다.

166차 적용(2026-08-06): Outcome & Alliance OS G6 Supervision & Research OS를 증거 게이트로 닫고 G7을 BUILD로 승격했다. 위험·정체·미해결 관계 사건 attention queue와 3클릭 원장 drilldown, metadata-only 교수자/AI 불일치 dataset·audit, curriculum gap, model/prompt/instrument/subgroup drift, Phase 3 네 도메인 artifact provenance를 역할 안전 원장/UI에 연결했다. 검증: G6 core/store/schema 28 passed, 6-signal queue 순서 정확, raw transcript row 0, drift expected/actual 일치, manifest 네 도메인 전건. 실제 DB/API 멱등/409·AI-view·역할/cohort RLS·audit, version/subgroup/artifact hydrate 통과. G6 UI desktop/mobile 6/6, typecheck/build를 통과했다.

167차 적용(2026-08-06→07): Outcome & Alliance OS G7 Multimodal Alliance의 내부 제품 범위를 완성했다. 동의 preflight, 한 오디오 시계의 익명 STT word·silence/overlap/interruption/prosody, 독립 text/voice 측정과 calibrated no-gain fusion, 비임상 상호작용 신호 계약, 원음/metadata 역할 경계, 철회와 audio/derived tombstone을 실제 API/DB 원장에 연결했다. 회기 리뷰에는 시간축·독립 측정·보존 경계와 음성 재연습 CTA를 제공한다. 검증: backend G0~G8 묶음 393 passed, 실제 API 멱등/변조409·RLS·융합 [true,false,false]·삭제, G7 desktop/mobile 8/8, session review 24/24, layout 15/15 + 8/8, G1~G8 최종 UI 묶음 84/84. 물리 마이크·공개 WSS·50분 장시간 실증은 B2 외부 게이트로 남아 있다.

168차 적용(2026-08-06→07): Outcome & Alliance OS G8 Autonomous Content & Continuous Improvement의 내부 제품 범위를 완성했다. source→draft→독립 red-team→benchmark→human catalog gate, 모델·릴리스별 baseline/threshold/provenance/rollback 증거 rail, append-only 승인·monitor·rollback lifecycle, 운영 incident의 4-node 회귀 DAG를 관리자 릴리스 제어석과 실제 API/DB에 연결했다. 자동 게시 버튼은 없으며 human gate 전에는 효과가 없다. 검증: G8 UI desktop/mobile 8/8, 기존 admin 40/40, 실제 API 멱등/변조409·401/403·4종 artifact·lifecycle 6·DAG 4/4, 금지 데이터 0. 현재 공개 OpenAPI에는 G7/G8 route가 각각 0개여서 실제 배포·public proof를 DONE으로 표시하지 않는다.

169차 적용(2026-08-07): G7/G8 외부 승격 전 로컬 릴리스 준비를 강화했다. 실제 loopback /voice/ws short soak는 8.015초 동안 연결 83/83·성공 발화 79·철회/재연결/overflow 복구를 통과했고 API/gateway 전체 805 passed지만, 물리 마이크·public WSS·실행된 50분 증거로 확대하지 않는다. G8 시각 QA는 승인 차단 이유를 상시 문구·aria-describedby·semantic form으로 고쳐 desktop/mobile 16/16과 build를 통과했다. 배포 프리플라이트는 G3~G8 독립 32자 토큰과 G0~G8 migration sentinel을 fail-closed로 검사한다. 당시 199파일 release-only patch는 clean HEAD git apply --check를 통과했으나 후속 병렬 편집으로 manifest와 달라져 무효화했으며, 재분류·결정적 재빌드 전에는 배포에 사용할 수 없다. 공개 OpenAPI의 G7/G8 경로는 재확인 시점에도 각각 0개라 두 카드 상태는 BUILD로 유지한다.

170차 적용(2026-08-07): 병렬 개발 결과를 학생 자기주도 수련의 실제 실행 경로로 통합했다. G1은 회기 전 pre pulse를 fail-closed로, 첫 라운드 뒤 mid pulse를 비차단형으로 연결했고 desktop/mobile focused 2/2와 시각 증거 4장을 보존했다. G4/G5 카드의 replay·branch·제약 응답·음성 재시도·난이도 사다리·미지 전이는 학습자 홈→사전 설정→실제 새 Session까지 typed launch intent를 유지하며 관련 UI 22/22와 통합 묶음 59/59를 통과했다. 현행 API 기준 learner/session/layout 묶음은 37/37, API/gateway는 767 + 45 passed, typecheck/build/API 계약도 통과했다. dirty 250개는 Outcome 관련 228·혼합 4·보존 제외 18로 전건 분류했고, 혼합 문서 exact hunk와 clean-source API 타입 재생성으로 만든 223파일 release-only patch를 두 번 동일하게 조립해 clean HEAD와 canonical clean index 적용 검사를 통과했다. 바이너리 시각 증거 4장은 manifest에는 관련 증거로 등록하되 텍스트 patch와 분리했다. G7 물리 마이크·공개 WSS·50분 실측과 G8 실제 배포·public proof는 여전히 BUILD다.

171차 적용(2026-08-07): G8 agentic worker를 기본 비활성 opt-in scheduler로 연결했다. repo-approved 비식별 source는 immutable app.ci_agentic_job, FOR UPDATE SKIP LOCKED lease, retry 상태로 관리하며 source usage·classification·본문 hash·PII를 engine 전에 재검증한다. 실제 claude_cli/claude-opus-4-8에서 generator 1·독립 reviewer 2·variant generator 1·독립 judge 3, 총 7 calls를 실행해 dev PostgreSQL reviewer 2·variant 3·pass rate 1.0·pending_human_approval을 저장했다. 동일 UUID replay는 model call 0, human approval/catalog row는 0, clinical claim은 false다. engine timeout·answer leakage·red-team finding 실패도 pipeline 저장 0건으로 증명했다. 전체 API/gateway 858 passed, Ruff·API type check·web typecheck·SSOT checker를 통과했다. 운영 drift trigger·사람 payload 검수 E2E·release-agent 폐루프 전까지 G8은 BUILD다.

171차 적용(2026-08-07): G7 voice code/internal 경계를 Deepgram streaming adapter와 운영 전환용 fail-closed 계약까지 확장했다. interim/final·word timestamp·provider event를 처리하고, word 원문 대신 deployment secret 기반 HMAC pseudonym만 저장한다. 열린 stream은 동의를 1초마다 재검사해 철회 시 abort하며, Session은 음성 단절 뒤 작성 중 텍스트와 텍스트 계속하기·키보드 재연결을 보존한다. WSS ready는 실제 STT/TTS provider/model을 반환하고 public runner v3의 mic-free preflight가 네 기대값을 exact match한다. full soak는 명시적 확인 전 장치를 열거하지 않는다. 운영 TTS는 OpenAI API gpt-4o-mini-tts로 고정하고 공식 앱 통합·출력 소유 근거와 회기 전·중 AI 생성 음성 고지를 반영했다. 검증: voice/G7 backend 73 passed, public runner 12 passed, disclosure desktop/mobile E2E, SSOT checker green. 실제 Deepgram key·quota live, expected provider/model authenticated public ready, 명시 동의 물리 마이크와 50분 soak가 없어 G7은 계속 BUILD다.

172차 적용(2026-08-07): G7 voice hardening을 235파일 release-only patch 3197805058e3…2bc로 clean worktree에서 재조립·검증한 뒤 공개 API 8001과 Cloudflare Pages production 6d7e89d5에 재배포했다. API는 새 clean 경로에서 prod/db/engine=true, OpenAPI 119 paths, 인증 401·Google OAuth 302를 유지하고 /voice/health가 STT openai/gpt-4o-transcribe·TTS openai/gpt-4o-mini-tts를 반환한다. 공개 WSS 비인증 차단은 1008, custom/immutable web은 새 index-DZZoYvZq.js와 AI 생성 음성 고지 포함 Session 청크를 올바른 MIME으로 제공하며, watchdog도 새 clean 경로로 재등록해 LastTaskResult=0을 확인했다. 운영 Deepgram key가 없어 streaming provider는 아직 활성화하지 않았고 authenticated ready·명시 동의 물리 마이크·50분 soak도 미실행이므로 G7은 계속 BUILD다.

173차 적용(2026-08-07): G7 완료감사에서 내부 과대주장을 바로잡았다. benchmark는 calibration 점수 재진술 대신 synthetic gold target에 대한 text-only와 calibrated multimodal의 1-MAE 0.9533→0.9673, gain +0.014(최소 0.01)를 직접 계산하고 gold 변조 반례를 통과한다. consent mutation·timeline·measurement는 session 공통 PostgreSQL transaction lock으로 직렬화했으며 실제 개발 DB 동시 철회에서 미커밋 writer 대기, 커밋 뒤 저장 차단, timeline row 0을 확인했다. route는 10MiB append 전 거부, transcript event queue 32, Deepgram receive queue 16을 사용하고 3초 loopback에서 연결 61/61·발화 57·overflow 복구·10MiB RSS probe를 통과했다. 다만 synthetic label은 독립 임상/파일럿 효과 증거가 아니고 단일 프로세스 probe는 실제 worker·Uvicorn·OS·Cloudflare high-water를 대체하지 않는다.

174차 적용(2026-08-07): 학생 자기주도 수련의 홈 추천→목표 선택→텍스트/SSE 회기→종료·리뷰→G4 처방→새 회기 재연습을 실제 src 제품 화면 하나의 상태 흐름으로 묶었다. desktop/mobile 2/2, typecheck와 고정 캡처 9장 직접 QA를 통과했다. 홈 핵심 CTA는 44px·4.5:1 이상 대비로 보정했고, 390×844·320×568 활성 회기의 아바타/문구 겹침 0·축어록/입력창 카드 내부 포함을 고정했다. 리뷰→재연습의 내부 criterion/counterevidence/UUID/영문 이론키는 사용자용 한국어로 치환했다. 이 브라우저 증거는 미소유 /api/**를 404로 닫은 로그인 없는 route fixture이며 실제 DB 폐루프가 아니다. 실 PostgreSQL production caller 증거와 UI 소비 증거를 분리해 기록한다. 리뷰 1~5 척도는 320px에서 3+2로 재배치해 다섯 선택지 44px 이상·내부/페이지 overflow 0과 desktop/mobile 8/8을 확인했다. 상세: ops/outcome-os-self-directed-learning-loop-ui-evidence-2026-08-07.md.

175차 적용(2026-08-07): 격리 NAS 프리뷰http://100.116.83.60:8088에 배포하고 실제 브라우저 회기와 review API의 저장 축어록 2턴을 확인했다. 전용 Compose 프로젝트·포트·네트워크·볼륨만 대상으로 배포했으며 기존 프로젝트 중단·재생성 명령은 실행하지 않았다. 매일 04:30 KST Vignette 회기 E2E 정기 검증(automation id vignette-e2e)을 ACTIVE로 구성했다. 새 기능이 material milestone이고 release-only patch 결정성·manifest·clean-index·NAS preflight가 모두 통과하며 배포 SHA가 달라질 때만 같은 격리 프리뷰를 승격한다. 실행 이력은 첫 스케줄 뒤 별도 증거로 남긴다. 증거: 배포 증거, 브라우저 증거. 이 프리뷰와 자동화는 G7 종료 증거가 아니다. 물리 마이크 캡처는 미승인이고 Deepgram 운영 키가 없어 G7은 계속 BUILD다.

176차 적용(2026-08-07): G8의 세 내부 결손을 병렬 구현·독립 감사로 닫았다. G6 drift 원장의 canonical 임계값·subgroup 근거를 대조하는 default-off trigger는 실 DB incident 1·DAG 4·job 1, 멱등·동시성·approval/catalog 0을 통과했고 문자열만 믿던 fail-open을 RED로 수정했다. 기존 실제 Claude pending 후보는 새 모델 호출 0회로 격리 8011/5181 관리자 browser에서 catalog 0→1·approval 1, learner/teacher 403·replay 멱등·변조 409·민감 projection 비노출을 확인했다. 별도 실엔진 후보의 answer leakage는 422·저장 0으로 차단했다. release agent는 material+changed SHA·patch 2회 결정성·manifest/clean candidate·API/Web/회기 gate·NAS snapshot/semantic runtime/browser·rollback·exact-SHA SSOT handoff를 구현했고, 독립 감사에서 active-state drift·경로 탈출·secret archive·병렬 volume 충돌 네 결함을 수정했다. 전체 API/gateway 891 passed, release governance 35/35, 관리자·자기주도·회기 desktop/mobile 26/26, API type·typecheck·build를 통과했다. 변경 SHA의 실제 격리 NAS 승격 전까지 G8은 BUILD다.

177차 적용(2026-08-07): G8 release-only SHA e9b482ccba61…e99를 격리 NAS vignette-preview-20260807에 실제 승격했다. Windows clean candidate의 bash\r DB init 실패, legacy env 경로 오판, 교체 직후 readiness 502를 각각 fail-closed RED로 재현하고 LF 정규화·snapshot env 추적/preflight·180초 bounded readiness로 수정했다. 선행 502 실행은 기존 이미지로 자동 rollback하고 health·OpenAPI 122·auth 401·이미지 ID를 재검증했다. 최종 실행은 API/Web 새 이미지, health ok·db/engine true, OpenAPI 123·auth 401·G0~G8, readiness 3회, 실제 postdeploy browser SSE→DB-backed review를 통과했으며 물리 마이크는 사용하지 않았다. release-agent 20/20, final session E2E 559.812s, browser review 26.921s. exact SHA를 TODO·백로그·manifest와 동기화해 G8은 DONE이다. G7 외부 증거는 그대로 BUILD다.

178차 적용(2026-08-07): G7을 가짜 외부 증거로 닫을 수 없도록 제품 동의와 종료 checker를 연결했다. Session은 처리 목적·전송/전사·침묵/속도/끼어듦 파생·30일 보존·원음 미보존·철회/삭제·텍스트 대안을 설명하고, 서버 consent ledger 성공 전 getUserMedia=0·voice WebSocket 0을 유지한다. 원장 지연·실패와 늦은 권한 응답도 capture를 남기지 않으며 Space를 제거하고 Alt+M을 안내한다. public runner v4는 turn별 interim ≥1·speech-final=1과 latency를, 관리자 runtime sampler는 worker/Uvicorn queue high-water를, Linux sampler는 exact image/container/cgroup/proc/Docker/TCP high-water를 기록한다. 별도 human contract는 synthetic/raw material을 거부하고 30명/50회기/150축·blind 2인·ICC/κ·10,000 cluster bootstrap을 재계산한다. 네 artifact는 같은 public host·겹치는 50분 시간창이어야 canonical checker를 통과한다. 검증: API/G7 92 passed, evidence runner/checker·release gate 31 passed, voice UI 2/2, typecheck·API type·Ruff·py_compile. 실제 마이크·운영 Deepgram·실제 참가자는 사용하지 않아 G7은 계속 BUILD다.

179차 적용(2026-08-07): G7 내부 hardening release-only SHA a8c27b0aadcb9dacea86c4be5e62e19277b9cc2678ebca51aa02998d2c2d1a0d를 격리 NAS vignette-preview-20260807에 승격했다. 첫 release-agent 실행은 새 동의 모달을 따르지 않던 DB-backed mic fixture 1건을 23/24에서 fail-closed로 차단하고 원격을 변경하지 않았다. fixture를 마이크→동의 원장→synthetic capture 순서로 고친 뒤 focused 1/1, clean candidate session E2E 24/24, API 전체, API contract·typecheck·build를 통과했다. 최종 API/Web 이미지 79ec…4450/c530…2f28, health ok·db/engine true, OpenAPI 124·auth 401·G0~G8, readiness 3회, NAS browser SSE→DB review를 확인했다. 물리 마이크는 사용하지 않았고 G7 외부 four-artifact gate는 계속 BUILD다.

180차 적용(2026-08-07): current source release-only SHA 6030a677af7e…c611를 격리 NAS vignette-preview-20260807에 승격했다. 최초 전체 gate는 108개 중 5개를 fixture drift 2종과 runtime-critical shell.css 분류 누락으로 차단해 원격을 바꾸지 않았고, G5→G4 무호출·StrictMode retry·learner 모바일 4열 packaging을 focused 6/6과 manifest 회귀로 고정했다. 최종 candidate browser E2E 108/108, postdeploy 실제 SSE→DB review 32.437s, health 3/3, OpenAPI 126·auth 401·G0~G8 route를 통과했다. API/Web 이미지는 52e0…8b2d/6fdb…f215이며 named DB volume과 배포 전 dump를 보존했다. 이 승격은 current runtime 증거이고 G8 receipt-bound 실제 image rollback은 별도 GATE다.

181차 적용(2026-08-07): G8의 마지막 게이트인 실제 receipt-bound image rollback을 격리 NAS에서 실행해 DONE으로 승격했다. 먼저 성립 불가능한 Gate6 계약을 정정했다. 감사 대상 current API 이미지 자체가 com.docker.compose.project=vignette-preview-20260807·service=api image label을 갖고 있어 "helper의 compose label 0개"는 감사되지 않은 다른 이미지를 쓰지 않는 한 성립하지 않는다. 그래서 계약을 key 부재가 아니라 소속으로 바꿔 scripts/launch-nas-preview-g8-helpers.py에 고정했다. image 상속 label을 baseline으로 읽고, container의 모든 compose label이 baseline과 같거나 선언된 격리 override인지 검사하며, 최종 project는 vignette-g8-helper-*·service는 g8-rollback-*이어야 하고, docker run argv에 target project/service label을 주입하면 fake-runner 테스트가 먼저 깨진다(37/37). 실행은 executor 127.0.0.1:18149(host network·read-only rootfs·cap-drop ALL·no-new-privileges·uid1028/gid100·group101)와 별도 lifecycle의 control-plane API 127.0.0.1:8018로 구성했다. 계획했던 Windows SSH 터널은 NAS sshd가 administratively prohibited로 direct-tcpip를 거부해 사용할 수 없었고, sshd 설정을 바꾸는 대신 같은 격리 계약의 NAS-side probe 컨테이너에서 실행해 control-plane(8018)·preview(8088) origin 분리를 그대로 유지했다. 결과는 rollback-old receipt nas-g8-723eeef2…, restore-current receipt nas-g8-2738846c…로 실제 이미지가 52e0/6fdb79ec/c53052e0/6fdb로 왕복했고, release gate·approval 2회 멱등, DB audit.ci_lifecycle_event rollback/executed 2건과 receipt id 결속, silent auto-promotion 0, HMAC journal 6-record 체인 검증, health 3/3·OpenAPI 126·auth 401·Web 200, helper 0·listener 0 복귀와 비밀 env 파기를 확인했다. down·volume rm·prune은 실행하지 않았고 공개 런타임은 건드리지 않았다. G7은 Deepgram live·인증 WSS·명시 동의 물리 마이크 50분·독립 라벨 human pack이 남아 외부 GATE로 유지한다.

182차 적용(2026-08-08): 회기 전 자기점검(pre alliance gate) 화면을 데스크톱·모바일 전 폭에서 다시 짰다. 계측이 먼저였다. gate 상태에서 카드가 align-self:stretch + grid-template-rows: auto minmax(0,1fr) auto auto인데 base flex의 align-items:center가 살아 있어 3축 블록이 1fr 행 한가운데 떠 있었다. 1920×1080 기준 카드의 66.5%가 빈 공간이고 축 위·아래로 각각 277px의 죽은 여백이 생겼다. 척도 라벨은 0.54rem+nowrap+ellipsis라 901~1279px에서 최대 12개가 "전허 아…"로 잘렸고, ≤620px에서는 display:none으로 15개 전부 사라져 숫자 1~5만 남았다. 320×568에서는 @media (max-width:420px) and (max-height:620px)의 collapsed 전용 40px 고정 행이 gate에도 걸려 카드가 40px로 눌리고 헤더와 축이 겹쳐 화면이 사실상 깨져 있었다. 수정은 네 가지다. (1) gate 카드는 행 높이만큼 늘리지 않고 align-self:center+max-height:100%+내부 스크롤로 화면 중앙에 서게 했다. (2) 3열 격자를 버리고 축마다 질문 한 줄 + 전폭 5칸 척도 세로 스택으로 바꿔 어느 폭에서도 라벨을 자르거나 숨기지 않는다(word-break:keep-all+overflow-wrap:normal로 어절 경계만 줄바꿈). (3) 정보가 없던 3 AXES 모노 배지를 제출 버튼이 왜 잠겨 있는지 답하는 0/3 축 선택함 진행 표시(aria-live)로 교체했다. (4) 40px 행 규칙에 :not(.sx-alliance-gated)를 걸어 collapsed mid 전용으로 되돌렸다. 선택 상태 글자색도 반투명 --surface에서 --text-on-accent로 고쳤다(라이트 4.85:1 · 다크 6.36:1, AA). 15개 뷰포트 재계측 결과 빈 공간 비율 0.665→0.127(1920), 라벨 잘림 12→0, 숨김 15→0, 최소 탭 타깃 38×38→46×60, 문서 가로 오버플로 전 구간 0이고, 320×568에서는 카드 내부 스크롤로 제출까지 도달해 실제 잠금·발화 입력 활성까지 확인했다. 인라인 mid 카드는 ≥1080px에서만 3열로 눕혀 축어록을 밀지 않게 두었고 높이는 오히려 약 55px 줄었다. 무회귀: typecheck 통과, session-layout 8/8, alliance-pulse 8/8, pre/mid 잠금 E2E 2/2, layout-visual-gate 22/23(실패 1건 settings는 변경 전 baseline에서도 동일 실패로 확인된 기존 회귀). session-mvp 음성 4건 실패도 baseline 동일이라 이 변경과 무관하다.

183차 적용(2026-08-08): 182차 뒤 소유자 스크린샷에서 시간 만료 상태의 게이트 화면이 여전히 깨져 있어 네 개의 별개 결함을 계측으로 특정하고 닫았다. (1) .sx-timebar는 세션이 다크 stage 팔레트를 강제하던 시절의 잔재로, 배경이 어디에도 정의된 적 없는 --bg-panel의 하드코딩 다크 폴백으로 칠해지는데 글자만 테마 토큰을 따라가 라이트에서 제목 1.13:1·설명 1.76:1이었다. 의미색 토큰(--warn-*/--crit-*)으로 되돌려 13.88:1·6.94:1(다크 13.86·9.30)로 올렸다. (2) 같은 이유로 .sx-end-dialog__panel이 어두운 gradient 위 어두운 글자라 제목 2.68:1·본문 1.14:1로 사실상 보이지 않았다. 불투명 --bg-app 표면으로 바꿔 15.79:1·5.19:1(다크 15.18·6.52)이 됐다. (3) 보태니컬 장식 위로 본문을 올리는 .sx-page--active > *{position:relative}가 같은 특이도(0,1,0)로 뒤에 있어 종료 모달의 position:fixed를 덮어썼다. 오버레이가 화면을 덮는 대신 그리드 한 칸(1532×32px)으로 눌려 들어갔다. :not(.sx-end-dialog)로 제외해 fixed 1600×900 뷰포트 전체를 회복했다. (4) 게이트 행 정의 .sx-page--active.sx-alliance-gated(0,2,0)가 :has() 두 개짜리 규칙(0,3,0)보다 특이도가 낮아 시간 만료 바가 뜨는 순간 밀려났다. 숨긴 축어록·컨트롤바의 빈 트랙이 남아 화면 절반이 비었다(80px 59px 628px 0px 116px 5행). 게이트 규칙에도 같은 :has()를 붙여 3행(80px 59px 693px)으로 정정했다. 무회귀: typecheck 통과, session-layout+alliance-pulse+layout-visual-gate 31/31(182차에서 실패했던 settings도 통과), 시간만료 종료 다이얼로그 E2E 2/2, pre/mid 잠금 E2E 2/2, full-sweep-session+self-directed-learning-loop 30 pass. 남은 음성 4건(voice skip·Space mic)은 변경분 stash 후 baseline에서도 동일 실패라 이 변경과 무관한 기존 회귀다.

184차 적용(2026-08-08): 182·183차 변경이 로컬 워크트리에만 있어 소유자가 보던 공개 사이트에는 반영될 수 없던 상태를 배포로 닫았다. 소유자 스크린샷의 3 AXES는 이미 소스에서 사라진 문자열이었고, 접속 주소가 https://vignette.chanpaca.net이라 커밋 전 변경이 보일 수 없는 것이 원인이었다. 커밋 f0c2240f로 고정한 뒤 npm run build(Session 청크 Session-DnhnKvTy.js·Session-Xn1JLv-d.css), scripts\preserve-pages-assets.ps1로 직전 5개 production 배포의 지연 로드 자산 104개를 보존하고(진행 중 세션의 lazy chunk 404 방지), wrangler pages deploy dist --project-name vignette --branch main --commit-hash f0c2240f로 배포했다(deployment a12c195c, 신규 업로드 37 / 기존 666). 커스텀 도메인 검증은 index-BTkJUPLZ.js 200, Session JS/CSS 모두 올바른 MIME 200이며 신규 마커(축 선택함·is-gate·:not(.sx-end-dialog)) 각 1건, 구버전 마커(3 AXES·--bg-panel·척도 text-overflow) 전부 0건이다. 첫 조회에서 edge가 이전 index를 준 건 배포 직후 타이밍이었고 재조회에서 신규 index로 확정됐다. 공개 API·런타임은 건드리지 않았다.

185차 적용(2026-08-09): 177·181차의 G8 DONE 판정은 rollback receipt gate 완료로 범위를 정정했다. 108/108은 localhost candidate 결과였고 같은 NAS 평문 origin에서는 secure-context 전용 crypto.randomUUID 예외로 회기 E2E 24건이 실패했다. 소스는 randomUuid()로 통일해 insecure-origin 6/6·API type·typecheck·build를 통과했지만 NAS에는 아직 미배포다. 따라서 G8 카드는 BUILD · RECEIPT DONE · RUNTIME REVALIDATION으로 되돌리고, clean-head release mode 구현→수정 배포→실제 NAS-origin 전체 회기 E2E GREEN까지를 남긴다. G7은 운영 기본 local_whisper/melotts의 current 공개 배포·인증 WSS·명시 동의 mic 50분·동시 runtime/topology·독립 human pack 전까지 외부 GATE다.

186차 적용(2026-08-09): 공개 DB listener 소실 사고는 Docker Desktop 중단으로 좁혀졌고 recovered named volume을 보존한 기존 컨테이너만 재기동해 복구했다. public/local health는 db·engine true, 당시 owner 집계는 users 171·sessions 93·turns 726이었다. 당시 워치독 action의 삭제된 옛 workspace 드리프트를 shared current workspace·5분 주기로 교정하고 즉시 실행 0을 확인했다. 이 임시 조치는 후속 source-pin에서 안전하지 않은 입력으로 판정됐고, 그 시점 task는 detached-clean pin 인자 부재로 mutation 전에 fail-closed했다. G8 clean-head release mode는 tracked-dirty 차단·HEAD/tree/archive 2회 결정성·archive-only candidate·patch 무회귀·evidence binding과 commit 전 NAS-origin 11-spec rollback gate를 unit 30/30으로 고정했고, 새 NAS preview predeploy dump 72698232…5d41c(1,015,222 bytes·TOC 1,752)를 보존했다. 같은 시점 G7 재감사에서는 공개 OpenAPI 119·/admin/voice-runtime 부재, OpenAI voice provider, local sidecar listener 0, Windows host topology와 Compose-only collector 불일치를 확인해 launcher·topology 선행 구현이 필요하다고 판정했다. 이 역사 스냅샷의 blocker는 후속 clean public 승격으로 해소됐다.

187차 적용(2026-08-09): G8 clean-head dry-run은 active 6030a677…c611→desired archive 6b1b15bd…a3f7를 mutation 0으로 결속했다. execute 1은 archive CRLF/API type byte-check에서, execute 2는 API·types·build 통과 뒤 session E2E 109 passed / 5 failed에서 모두 승격 전에 fail-closed되어 NAS active/image/DB는 바뀌지 않았다. source-only UUID 4건은 production 번들에서 /src/lib/uuid.ts import가 불가능한 gate 배치 오류라 별도 Vite gate 6/6으로 분리했다. 남은 실제 제품 blocker는 timezone 없는 started_at을 KST 브라우저가 약 9시간 경과로 오인해 시간종료 모달이 정상 코칭 이력을 가리는 문제다. backend UTC offset/Z 계약과 focused disposable DB/browser 회귀를 닫고 새 clean commit을 만든 뒤에만 NAS 배포를 재개한다.

188차 적용(2026-08-09): 회기 시간 P0를 우회 없이 수정했다. browser-facing started_at/ended_at과 learner/teacher dashboard timestamp는 UTC +00:00을 반환하고, 리뷰의 달력 날짜는 서버 locale 대신 KST(+09:00)를 사용한다. backend 관련 65 passed, 후속 voice 계약을 포함한 API 전체 921 passed, Ruff·compile·web typecheck를 통과했다. 고유 Compose DB/API/Web/engine과 Asia/Seoul browser에서 코칭 이력 focused 1/1은 active/null·UTC suffix·10분 미만 경과·timebar/dialog 0·reload 후 coach mark 실제 클릭과 source-pack dialog를 확인했다. 종료 뒤 container·volume·listener 0이다. 이제 새 clean commit 결속과 NAS-origin 전체 E2E가 남았다.

189차 적용(2026-08-09): G7 외부 실행 전 P0를 소스에서 닫았다. production runner exit 0은 canonical checker 0·gate_closed=true에 결속하고, browser Origin allowlist를 API/WSS/admin/topology transport host·scheme과 분리했다. capture는 최소 3,120초·ceil+terminal sample이며 checker는 voice/runtime/topology 공통 교집합 3,000초를 강제한다. Windows 증거는 detached-clean commit/tree, runner/collector/checker SHA, psutil==6.1.1을 매 sample 전후 검증한다. fresh public launcher는 mutation 전에 source·Python·cloudflared·config SHA를 고정하고, legacy API와 exact-config cloudflared를 bounded 교체해 새 PID/start/exe·command SHA/실제 cwd의 raw command-line 없는 receipt를 남긴다. receipt destination은 runtime mutation 전에 create/flush/atomic-replace 권한을 검사하고 기존 receipt를 보존한 채 원자 게시한다. 검증: G7 runner/checker/topology 86/86, launcher/sidecar 80/80, 통합 166/166, API 921, gateway 58, Web api-types·typecheck·build, 자기주도 desktop/mobile 6/6, Ruff·compile·PS5.1 parser·diff-check PASS. 실제 public 실행·마이크·사람 평가는 하지 않았으므로 G7은 external GATE다.

190차 적용(2026-08-09): exact include 52개를 clean commit 5221f79e…1c69으로 고정하고 tree e4f15001…308b, 2회 동일 archive 1109bf86…0f4b를 결속했다. fresh NAS dump 6f4b95a7…b529f(1,015,222 bytes·TOC 1,752/TABLE DATA 129) 뒤 execute는 API 921·types·typecheck·build·insecure-context 6/6·candidate DB 회기 후반까지 통과했지만 110/112에서 승격 전에 fail-closed했다. 실패 2건은 Vite entry /src/main.tsx만 차단하던 boot 진단 테스트가 production hashed entry /assets/index-*.js를 차단하지 못한 환경 계약 누락이었다. 두 entry를 함께 차단하도록 고쳐 Vite source 2/2와 production preview 2/2를 통과했다. NAS mutation·rollback·DB migration은 0이며, 테스트 수정의 새 clean commit을 재결속한 한 번의 execute가 남았다.

191차 적용(2026-08-09): 후속 clean commit 21461ab3…6fde·tree 5c5f12a8…524e·archive 20d49694…fa1a는 candidate 112/112를 통과하고 NAS 새 API/Web d5021950…/376a3aa8…를 올렸다. 실제 NAS-origin postdeploy G4 desktop/mobile 2건이 110/112에서 실패하자 active-state commit 전에 이전 52e0e816…/6fdbb646…로 자동 rollback했고 health·auth 401·OpenAPI 126·G0~G8 route·image ID를 재검증해 rollback verified로 종료했다. exact-image 평문 origin에서 문장 fingerprint의 crypto.subtle.digest 의존이 요청 전 예외를 내는 원인을 확인했다. 원문 외부 전송 없이 portable SHA-256 fallback을 추가하고 표준 digest를 payload에 exact 고정해 secure localhost 2/2와 Tailnet insecure origin 2/2를 통과했다. 새 clean commit의 전체 candidate+NAS-origin 0 failure 전까지 G8은 runtime REVALIDATION이다.

192차 적용(2026-08-09): G8 clean-head 최종 승격을 완료했다. source HEAD 61a41d1f…6af·tree 87dec55d…3b77에서 2회 동일하게 만든 archive 4d15d055d74f…119d4d를 active release로 고정했고 candidate session E2E 112/112와 실제 http://100.116.83.60:8088 평문 NAS-origin browser review 112/112(11 specs, desktop/mobile/single-run)를 모두 통과했다. 실행 이미지는 API d5021950…e4b1·Web 9796c092…4b36이며 health는 status=ok·db=true·engine=true, 비인증 auth 401, OpenAPI 126을 재확인했다. execute 직전 fresh custom dump 36ec8748…24db8(1,097,100 bytes, TOC 1,738 / TABLE DATA 129)를 보존했고 이전 active 6030a677…c611과 이전 이미지는 rollback 기준으로 남겼다. 앞선 fail-closed·verified rollback 이력은 삭제하지 않는다. 이 증거로 G8을 DONE으로 승격하며 남은 Outcome OS gate는 G7 external proof다.

193차 적용(2026-08-09): 학생 화면의 320×568 신뢰성 게이트를 닫았다. 처방 재연습 prestart CTA를 첫 화면에 유지하고, active 회기의 마이크·일시정지·종료를 모든 밀도 구간에서 최소 44px로 고정했으며, 대시보드의 긴 privacy token과 owner grid가 320px 문서를 384px까지 넓히던 overflow를 제거했다. typecheck, session-layout desktop/mobile 8/8, dev-dashboard desktop/mobile 10/10, 자기주도 focused 16/16을 통과했다. 동시에 NAS 112건을 실 API/DB 22와 route fixture 90으로 정직하게 분리하고, clean HEAD/tree·전용 disposable stack·동일 학습자 SSE→review→G4/G5 0→1→1·exact cleanup을 강제하는 주기 runner를 추가했다. unit 11/11과 Compose preflight는 통과했다. G7 human pack은 category·κ≥0.70·preregistration·paired completeness·결측 ITT를 캡처 전에 검증해 부적합 pack이면 마이크를 열지 않는다.

194차 적용(2026-08-10): 주기 runner의 최초 세 full run은 모두 전용 clean stack에서 fail-closed했다. 1차는 성공 SSE의 body를 다시 읽는 CDP 오류, 2차는 UI 2턴만 보고 durable 저장 전에 종료해 리뷰가 기록 없음, 3차는 서버가 의도적으로 닫지 않는 SSE에 response.finished()를 기다려 20분 상한에 도달한 하네스 결함이었다. 세 번 모두 fixture review-ready·stack health는 통과했고 공개 8001·실 DB 55432·engine 9099·NAS 접촉 0, container/volume/network/listener/temp 잔여 0이었다. 현재 소스는 자동 retry 0과 GET /sessions/{id} durable turn 2개 poll만 완료 신호로 사용한다. 같은 단계 반복 원칙에 따라 이번 턴에는 더 실행하지 않으며, 다음 clean single run의 첫 GREEN receipt 전까지 주기 실회기 검증을 완료로 표기하지 않는다.

195차 적용(2026-08-10): clean HEAD 13d1c39a…·tree beb93801…의 4차 수동 full run은 앞선 SSE hang을 제거해 6.3분에 종료했고, 실제 동일 학습자 SSE·review ready·G4 첫 POST와 원장 count 0→1까지 통과했다. 이후 full page reload에서 이미 저장된 현재 회기 episode를 카드가 hydrate하지 않아 원장 반영됨 대신 학습자만 실행으로 되돌아가는 제품 정직성 결함을 fail-closed했다. receipt periodic-learner-e2e-20260810-003150.json은 공개·NAS·active DB 접촉 0과 container/volume/network/listener/temp 잔여 0을 증명한다. UI는 현재 session+prescription의 persisted episode를 read model에서 복원해 현재 원장 상태와 재확인 행동을 표시하도록 수정했고, 실제 reload를 포함한 자기주도 route fixture desktop/mobile 6/6·typecheck를 통과했다. full runner는 재시도하지 않았으므로 첫 GREEN receipt와 자동 주기 승격은 여전히 미완료다.

196차 적용(2026-08-10): clean HEAD 9a7dd98c…·tree 1dce20c5…의 5차 단일 full run은 실제 동일 학습자 브라우저 단계에서 SSE·review ready·G4 0→1→1·G5 0→1→1을 78초에 모두 통과해 핵심 폐루프 첫 GREEN을 만들었다. 다만 같은 fixture를 이어서 사용한 returned-practice desktop/mobile 회귀가 이미 적재된 G4/G5를 초기 0으로 오인해 2/4 실패했고 전체 receipt periodic-learner-e2e-20260810-010038.json은 정직하게 FAILED다. 공개·NAS·active DB 접촉 0, container/volume/network/listener/temp 잔여 0은 유지했다. runner는 핵심 폐루프와 후속 회귀 전에 각각 새 학습자·회기 fixture를 준비하도록 분리했고 unit 12/12·Ruff·compile을 통과했다. 실패 화면에서 리뷰 요약 literal [NAME]/[ORG]익명 내담자가고 조사 결함도 발견해 표시 전용 자연어 치환과 복합 조사 우선순위를 보강했고 session-review desktop/mobile 2/2·typecheck·build를 통과했다. 당시에는 전체 GREEN receipt가 없어 자동 full runner를 등록하지 않았다.

197차 적용(2026-08-10): clean HEAD 4cd35488…·tree 001a7c74…의 6차 full run은 핵심 폐루프를 두 번째로 통과했고, 별도 returned-practice fixture도 초기 G4/G5 0을 증명했다. desktop G4/G5 2건은 GREEN이었지만 desktop이 만든 성공 상태를 mobile G4가 다시 읽을 때 테스트가 반영 상태 다시 확인 대신 최초 버튼을 찾아 5분 timeout, mobile G5는 serial 중단됐다. receipt periodic-learner-e2e-20260810-012909.json은 FAILED이며 public/NAS/active DB 접촉 0·exact cleanup GREEN이다. mobile 성공-state locator를 교정했고 실패 화면에서 추가로 확인한 강점·개선점·다음 문장·내담자 반응·워크시트 근거의 literal [NAME]/[ORG]도 저장/API는 유지한 채 표시층에서 자연어화했다. focused session-review desktop/mobile 2/2·typecheck·live spec 4건 collection을 통과했지만 full runner는 재실행하지 않았다.

198차 적용(2026-08-10): clean HEAD aa81af29…·tree 3901d71c…의 7차 full run이 499.8초에 첫 전체 GREEN receipt periodic-learner-e2e-20260810-020117.json·SHA-256 bae963de…f32e1a를 만들었다. 실제 브라우저 same-learner session 생성·SSE·review ready·G4/G5 0→1→1, 별도 zero-state returned-practice desktop/mobile 4/4, route mock 0을 통과했다. public 8001·active DB 55432·engine 9099·NAS 접촉은 0이며 전용 container 4·volume 3·network 1·engine PID와 6578-6581 listener는 cleanup 뒤 모두 0이다. 기존 vignette-e2e hourly heartbeat는 중복 생성 없이 갱신해 최신 GREEN이 6시간 이상 오래됐거나 material milestone이 바뀐 때만 preflight 뒤 full runner를 최대 1회 실행하고, 실패 시 같은 heartbeat에서 재시도하지 않는다. G7 human pack evaluator·runner/checker와 후속 intake compiler 계약도 103/103으로 재검증했으며 물리 마이크는 열지 않았다.

래스터만 사용이미지 생성 도구 산출물은 PNG 기반 시안이다. SVG·벡터·와이어프레임·로고 시트로 해석하지 않는다.
기능 우선메인 라우트의 실제 액션과 정보 구조를 먼저 반영한다. 장식은 기능을 가리지 않는 수준에서만 쓴다.
온화하지만 임상적종이 질감, 낮은 채도, 차분한 빛은 허용하되 상담 훈련 도구의 신뢰감을 먼저 세운다.
반응형 세트각 핵심 화면은 한 장 안에 PC·태블릿·모바일을 함께 배치해 전환 규칙을 비교한다.
화면추출한 핵심 기능디자인 의도
로그인/진입Google OAuth, 허용 도메인 안내, 로컬 역할 선택, 교육용 비치료 고지신뢰·보안이 먼저 보이는 조용한 진입 화면
학습자 홈학습 요약, 진행/리뷰 가능 회기, 마지막 세션 리캡, Live2D 감정 힌트, AI 코치, 학습·기록 드릴다운오늘 이어갈 회기와 학습 상태가 먼저 보이는 개인 대시보드
상담 세션회기 단계, 내담자 컨텍스트, 아바타, 음성 오브, 실시간 자막, 텍스트 폴백, 안전 점검화면 중심은 내담자, 피드백은 조용한 신호
회기 리뷰요약, 감정 밸런스, 회기 흐름, 축어록, 기법 태그, 개선점, 오디오/PDF점수 폭격이 아니라 근거 기반 회고
교수 콘솔리뷰 대기 큐, 코호트 현황, 페르소나 검수, 종료 회기 목록awareness보다 triage에 가까운 교수자 작업대
관리자 콘솔운영 홈: 교육 진행·온라인 사용자·헬스 샘플 이력·AI 비용·운영 티켓 요약. 하위 메뉴: 사용자 관리, 접근 권한, 운영 티켓 처리 큐. 헬스 샘플은 화면 조회와 synthetic sampler가 같은 DB 이력에 남김상태 관측과 관리 작업을 분리한 실제 운영 콘솔
설정계정, 관리자 AI 운영 설정, 지원 요청 현황, 테마, 음성 프리셋, 속도, 알림역할별 설정과 본인 지원 요청 상태만 보이는 조용한 환경 관리
이미지 요소종이 질감, 상담실 책상, 노트, 식물, 부드러운 빛, 패턴, 아바타 분위기UI 뒤에서만 느껴지는 따뜻함과 반구상 내담자 톤

상태 보드

현재 추적 중인 작업을 카드로. 요약만 노출되고, 상세 근거·검증 로그는 카드를 펼쳐야 보인다. 필터로 "내 차례"·블로커만 추려 볼 수 있다.

필터

한신대 PDF 정합성 · 이번 세션 발견

원천 기술분석 PDF(트웬티온스×한신대, 19쪽) 전수 정독 대조 (2026-06-27)
현재

PDF가 차별 기술로 꼽은 '저항·반응 조절'(AI가 너무 착하지 않게, 실제 환자처럼)·상태머신(라포→탐색→개입→정리)·RAG(자료검색)·이론모드(인간중심/CBT)·답변과 분리된 가드레일·SSE 스트리밍·React19·피드백 JSON Schema 강제(벤더중립)가 이미 구현·정렬됨. Stanford RCT(피드백 없는 연습=역효과)도 H2 턴평가로 충족 방향.

권고

이 코어를 '교육용(비의료)' 포지션으로 유지. 평가는 교수자 검토용 보조지표로 표기.

현재

라이브 테스트에서 수련생이 내담자를 "수동적 패배자"라 비난·조롱("웃음이 나오십니까")해도 민재가 공손히 흡수 → 훈련 가치 훼손. 수정: ① L0에 무례·모욕·조롱·인신공격 시 현실적 동맹 균열(위축·방어·따지기·종결의향) 지침 ② PersonaCard.triggers(역린) 필드 + CCD 핵심상처 파생 역린 블록(상담자가 핵심상처를 조롱·확정·강요·평가절하 시 가장 강한 반응). PDF '저항·반응 조절' 핵심 차별 강화. 무회귀 77/77.

잔여

P1~P3 명시 triggers는 임상팀 정밀 저작(현재 CCD 파생 기본값으로 작동). 라이브 재현 검증.

현재

PDF(9·16·18쪽): 자해·자살 감지 시 대화 중단 + 자살예방상담 109 안내 + 지도교수 자동 알림, 안전은 LLM 밖 별도 CrisisGate. 구현: CRISIS_HOTLINE_NUMBER=109, TurnResponse.crisis_resource/conversation_stopped, REST·SSE·voice 경로의 엔진 호출 전 중단, app.safety_events detail 적재, 교수자 대시보드 안전 알림 큐.

검증

pytest app/test_session_turn_persistence.py app/test_voice_ws.py -q 20 passed, 안전 이벤트 DB insert payload 테스트 포함. pytest app/test_teacher_dashboard.py app/test_session_turn_persistence.py app/test_voice_ws.py -q 21 passed.

잔여

비밀보장 예외고지·생명유지서약 등 임상 문안, 실시간 push/메일 알림, 지역 자원 확장, 운영 정책 문구는 소유자·임상팀 확정 필요. 현재 교수자 알림은 safety_events 기반 대시보드 큐다.

현재

TeacherDashboardResponse.learner_growthGET /teacher/learners/{learner_id}/analysis가 턴별 fast-loop 평가의 appropriateness, rapport_signal, 기법 태그를 학습자별로 집계한다. /teach는 검토 큐·위기 알림·페르소나 검수·최근 회기 triage만 맡고, /teach/analysis는 검색 가능한 1행 학습자 테이블을 먼저 보여준다. 우측 펼침 버튼은 행 아래에 회기별 미니 추이, 평균 라포, 변화폭, 기법 태그, 최근 기록을 확장하고, 이름 또는 상세 보기 버튼은 ?learner= 상세 화면으로 들어간다. 상세 화면은 추이·전체 회기·단계 분석 탭으로 나뉘며, 회기 행은 /teach/session/{id}/review로 진입해 같은 회기 리뷰를 교수자 읽기 전용으로 연다. 평가가 없는 회기는 "평가 부족"으로 남겨 가짜 곡선을 만들지 않고, 워크시트는 학습자 제출물 수정 없이 검토 전용으로 표시한다.

검증

python -X utf8 -m pytest -p no:cacheprovider app/test_teacher_dashboard.py -q 6 passed, npm run check:api-types, npm run typecheck, npm run build passed. PLAYWRIGHT_PORT=5215 npx playwright test e2e/teacher.spec.ts --project=chromium-single-run --workers=1 9 passed, PLAYWRIGHT_PORT=5217 npx playwright test e2e/layout-visual-gate.spec.ts --project=chromium-single-run --workers=1 12 passed.

잔여

자기효능감·기술숙련도·수련만족도 사전사후(H1)와 교수자 코멘트/검수 워크플로 확장은 별도 평가설계·임상팀 문항 확정이 필요하다.

현재

교수자/관리자는 /sessions/{id}/review를 읽을 수 있고, 학습자 워크시트 저장은 learner 전용으로 유지한다. 교수자 검토 상태는 app.session_review_statusreview_status, review_note, reviewed_at로 저장되며, teacher dashboard 응답과 SessionReview가 이 값을 표시한다. PUT /teacher/sessions/{session_id}/review-status는 교수자 메모 저장과 검토 완료 처리를 담당하고, 검토 완료된 회기는 pending queue에서 제외한다.

검증

pytest app/test_teacher_dashboard.py app/test_rbac_idor.py app/test_learner_dashboard.py -q 12 passed, npm run check:api-types, npm run typecheck, npm run build, teacher.spec.ts 4 passed. 교수 콘솔 검토 큐 노출과 학습자 리뷰의 교수자 전용 빈 grid 제거는 E2E/시각 게이트로 재검증했다.

잔여

임상 루브릭·최종 검수 기준은 외부 정의 전까지 완료 처리하지 않는다.

현재

교수자 성장 집계와 중복되던 점수·라포·기법 계산을 app.services.session_metrics로 공용화했다. GET /sessions/dashboard는 학습자 본인 세션만 집계해 overview, growth, persona_progress, achievements, recent_feedback를 반환하고, LearnerHome은 누적 회기·리뷰 대기·최근 평가·라포 흐름·페르소나별 진행·최근 피드백·마지막 세션 리캡을 실제 서버 데이터로 보여준다. 성취는 공식 수료/등급이 아니라 실제 연습 milestone만 사용한다.

검증

pytest app/test_learner_dashboard.py app/test_teacher_dashboard.py app/test_rbac_idor.py -q 12 passed, npm run check:api-types, npm run typecheck, npm run build, learner.spec.ts 6 passed, session-review.spec.ts 2 passed, layout-visual-gate.spec.ts 9 passed, session-layout.spec.ts 4 passed.

잔여

UX 감사 기준으로 2차에서는 카드 격자 비중을 줄이고 게이지·small multiples·테이블 중심으로 정리해야 한다. 모바일에서 임상 요약을 단순 숨김 처리하는 부분도 접힘/요약으로 바꾸는 게 맞다.

현재

① PDF: 고성능(Claude·GPT=내담자발화·실시간평가)/저비용 한국어(Solar=단순응답·사후요약) 2단계 + 캐싱 90%절감. 현재 client AI는 claude_cli 기본 라우팅, fast/deep evaluator는 EVALUATOR_FAST_MODEL/EVALUATOR_DEEP_MODEL 설정 시 모델 override를 gateway에 전달한다. evaluator structured 결과는 canonical request SHA-256 기반 인메모리 semantic cache 1차로 중복 호출을 줄이며, 원문 prompt·completion은 캐시에 저장하지 않는다. 벤더중립 인터페이스와 L0~L2 cache hint/session reuse도 유지한다. ② 백엔드 방향은 Node.js 우선 교체 가능성으로 정했다. 단, 현재 Python/FastAPI는 납품 핵심 경로라 전면 재작성하지 않고, 계약 경계를 먼저 고정해 갈아치울 수 있게 만든다. 이번 패스에서 앱 orchestrator가 raw gateway SSE line을 직접 해석하지 않도록 EngineClient.stream_packets() 경계를 추가했고, Python gateway의 /v1/generate 응답은 GenerateResponse 계약 모델로 반환한다. gateway-default는 실제 provider 모델명이 아니라 gateway 기본 라우팅 sentinel로 계약 모듈이 소유하며, FastAPI client와 Python gateway는 이 값을 explicit model override 없이 정규화한다. 추가로 app/session_read_model.pyapp/persona_read_model.py가 세션·페르소나 브라우저 응답 DTO와 builder/mapper를 소유하고, app/persona_generation_contract.py가 페르소나 draft schema/prompt/payload coercion을, SessionEvaluationWrite.from_result()/from_error()가 session evaluation write packet 생성을 소유하게 해 Node read/write API가 따라야 할 contract 경계를 분리했다.

권고

2-tier 후속은 client AI/요약 모델 정책, evaluator cache의 운영 hit-rate 관측, 장기 한도 정책으로 점진 도입한다. Node 전환은 이미 고정한 engine_gateway, structured_payload_from_response(), session_read_model, persona_read_model, persona_generation_contract, SessionEvaluationWrite 계약을 유지한다. live Node gateway endpoint conformance는 실제 Node gateway 구현이 생긴 뒤 붙이고, admin mapper cleanup은 RBAC/audit/RLS blast radius 때문에 뒤로 둔다.

현재

2026-06-27/28 기준선에서는 SEO/GEO 공유 카드, 온보딩 반영 E2E, 학습자 홈, 회기 시작/종료, 리뷰 공유 버튼, 음성 성공 경로, 레이아웃 회귀를 npm run e2e 113 passed + npm run typecheck/npm run build로 닫았다. 이후 다크 UI v2와 Node 전환 경계 보강은 현재 변경 범위에 맞춰 focused gate로 재검증한다. 최신 다크 UI v2 증거는 learner.spec.ts+session-review.spec.ts 9 passed, session-layout.spec.ts 8 passed, layout-visual-gate.spec.ts 9 passed다.

다음

남은 원천문서 갭, 임상 루브릭/최종 평가설계, public Google OAuth 실제 /turn, 배포지 운영 비밀값 주입을 순서대로 닫는다.

원천문서 갭 분석

산학협력 원천문서 5종 정독 + 코드 교차조사 (2026-06-26). 근거: source-docs-gap-analysis-2026-06-26.md · critical 3 / high 4 / medium+ 6
현재

doc1/4/5가 1급 산출물로 요구하는 워크시트 축(탐색 11항목·호소 5영역·인지삼제·1/2차 감정·보호/방해 4사분면·생물심리사회 목표)을 SessionReviewResponse.caseWorksheet로 노출한다. 서버는 저장된 축어록만 근거로 규칙 기반 초안을 만들고, 프론트 리뷰 화면은 근거 턴으로 점프 가능한 워크시트를 편집할 수 있다. 저장본은 PUT /sessions/{id}/review/worksheetapp.case_worksheet에 저장되고, 이후 GET /reviewsaved_by_learner 워크시트를 자동 초안보다 우선 반환한다. 3차에서는 임상팀 확정 루브릭을 코드 수정 없이 받을 수 있도록 data/rubrics/case-worksheet-rubric.json, case-worksheet-rubric.schema.json, app.services.case_worksheet_rubric, scripts/check-case-worksheet-rubric.py를 추가했다. 현재 rubric은 status=scaffold_only, scoring_enabled=false이고, 5개 section/28개 worksheet item key가 서버 생성 워크시트와 일치하는지만 검증한다. 64차에서는 템플릿 key source를 CASE_WORKSHEET_SECTION_SPECS/case_worksheet_template_item_keys()로 명시해 validator/CLI/test가 같은 생성 워크시트 spec을 참조한다. 73차에서는 app.session_review_status에 워크시트 수동 검수 상태·메모·시각을 붙여 교수자/관리자가 승인·수정요청·반려 결정을 남길 수 있게 했다.

검증

py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_session_turn_persistence.py app/test_teacher_dashboard.py app/test_rbac_idor.py app/test_case_worksheet_rubric.py -q 40 passed, py -3.11 -X utf8 scripts/check-case-worksheet-rubric.py --json PASS(items_total=28, scoring_enabled=false, sha256 provenance), py -3.11 -X utf8 -m py_compile focused files, npm run generate:api-types, npm run check:api-types, npm run typecheck, npm run build, session-review.spec.ts 3 passed. 로컬 API smoke: 세션 생성→워크시트 저장→GET /reviewsaved_by_learner:local smoke saved worksheet 반환.

잔여

임상팀 확정 루브릭 콘텐츠, level anchor, 가중치, 컷오프, 예시 답안, AI 채점 적용/calibration, 승인 후 잠금·재제출 정책, 재귀학습 데이터셋 approved 연계는 후속이다. 현재 scaffold는 형식 검증과 로드 경로, 교수자 수동 판정 저장만 보장하며, 초안/저장본은 숨은 정답키나 임상 점수 없이 학습자 편집 산출물로만 취급한다.

현재

prepare_turn→state_machine.evolve에 crisis.risk_level을 ideation_observed로 전달(위기 관측 상태머신 반영). escalate=True 시 REST·SSE·voice가 엔진 호출 전 중단하고 app.safety_events에 109 resource와 conversation_stopped를 적재한다. 교수자 대시보드는 이 레코드를 안전 알림 큐로 표시한다. 안전 이벤트 insert payload는 test_record_safety_event_writes_teacher_alert_payload로 회귀화했다.

잔여(임상팀)

비밀보장 예외고지·단계적 탐색·생명유지서약 스크립트 콘텐츠 + 실시간 교수자 push/메일 + 위기탐색 누락 회기리뷰 감점.

현재

TurnContext+prepare_turn에 theory_mode, sessions/voice가 sess.theory_mode 전달, evaluator._theory_mode가 세션 이론(학습자 선택) 우선. 교수자 수동 session 재평가도 persona 기본 theory_target보다 session theory_mode를 우선하고, turn 재평가는 TurnContext.theory_mode를 채운다. build_turn_messagesTHEORY_MODE_GUIDANCE를 통해 인간중심·CBT·통합 이론 프레이밍을 엔진 메시지에 넣는다. 프론트 Session.tsx는 기본값을 persona.theory_target에서 잡되, 세션 시작 전 humanistic/cbt/integrative segmented control로 학습자가 명시 선택할 수 있다. 선택값은 POST /sessionstheory_mode로 전송된다. 검증: npm run typecheck, npm run build, C3 backend focused 31 passed, eval route focused 5 passed, 평가/알림/세션 focused 39 passed, session-layout.spec.ts desktop/mobile 8 passed, session-mvp.spec.ts single-run 1 passed, layout-visual-gate.spec.ts 9 passed.

잔여(임상팀)

CBT 이론별 단계 프롬프트 체인 콘텐츠 + 이론부합 채점 루브릭은 후속이다. 이번 UI는 임상 문안·루브릭·백엔드 enum을 확장하지 않았다.

현재

doc4가 요구한 3척도 pre-post에 대해 app.learner_prepost_measure 원장, 학습자 본인용 GET/PUT /users/me/prepost-measures, SessionReview의 파일럿 증거 원장 카드를 연결했다. 저장 shape는 measure_name(self_efficacy/skill_proficiency/training_satisfaction), timepoint(pre/post), raw/min/max score, instrument_version, item_count만 받으며, 문항 텍스트·효과크기·p-value·pass/fail은 만들지 않는다. app.services.phase3_kpi_exportscripts/export-phase3-kpi.py는 원장 row를 Phase 3 evidence root의 02-measures/prepost_measures.csv02-measures/kpi_report.json으로 산출한다. participant id는 P3-###로 가명화하고, 3척도 paired normalized mean pre/post/delta, complete/missing pair를 report에 채운다. 77차에서는 phase3_kpi_contract.py가 metric 이름·필수키·status를 소유하게 해 exporter와 checker의 계약 drift를 줄였다. report metric status는 계산된 3척도 pre/post evidence를 computed_prepost, 공식 평가설계 전이라 계산하지 않는 지표를 design_pending으로 구분한다. 화면과 report 모두 공식 효과성·성적·수료 판정이 아니라 파일럿 evidence 계산임을 유지한다.

검증

py -3.11 -X utf8 -m py_compile apps\api\app\services\phase3_kpi_contract.py apps\api\app\services\phase3_kpi_export.py apps\api\app\test_phase3_kpi_export.py apps\api\app\test_phase3_artifact_checker.py scripts\check-phase3-artifacts.py scripts\export-phase3-kpi.py, py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_phase3_kpi_export.py app/test_phase3_artifact_checker.py -q 10 passed, py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_user_support_tickets.py app/test_runtime_policy.py app/test_admin_ops.py app/test_phase3_kpi_export.py app/test_phase3_artifact_checker.py -q 46 passed, PLAYWRIGHT_PORT=5205 npx playwright test e2e/session-persistence.spec.ts --project=chromium-single-run --workers=1 7 passed, py -3.11 -X utf8 scripts\export-phase3-kpi.py --help, py -3.11 -X utf8 scripts\check-phase3-artifacts.py --help. 기존 API/UI 검증은 API types/typecheck, SessionReview focused E2E 3 passed, visual gate 2 passed.

잔여

평가설계·공식 문항 확정, 실험/통제군 배정, 추이 시각화, 통계 검정 종류/alpha/결측 처리, 실제 20명 파일럿 evidence와 steward/legal/IAA 검수는 아직 남아 있다.

현재

텍스트 /turn·/stream·음성 경로에서 fast-loop 턴 평가를 app.feedback_scores, app.turn_technique, app.turn_client_state, app.supervisor_comment, app.alternative_utterance로 정규화 적재 후 리뷰 조회에서 hydrate한다. 평가 훅 예외와 evaluator error dict는 정상 neutral 점수로 둔갑하지 않게 evaluation.error로 남기고, 리뷰에는 턴 평가 실패 노트로 표면화하며, 성장 점수·최근 피드백 집계에서는 제외한다. 이번 패스에서 app/services/live_coach.py, data/kb/live_coaching_workbook_0615.json, data/kb/live_coaching_sources/*.json, POST /sessions/{id}/live-coach, GET /sessions/{id}/live-coach, POST /kb/live-coach/source-packs/sync, app.live_coach_events를 추가했다. 세션 UI는 코칭 모드에서 AI 코치 아바타 말풍선으로 즉시 개입하고, "근거 보기" 모달과 학습자 발화 우측 C 마커를 통해 받은 코칭 이력을 채팅 위 스크롤 오버레이로 보여준다. 저장 payload는 PII 마스킹 excerpt + 코칭 구조화 JSON이며, 공식 자료는 허가된 source pack의 version/citation/summary로 넣고 장문 원문·공식 문항을 재현하지 않는다. 같은 source pack은 app.services.source_pack_sync를 통해 evaluator 전용 RAG에 증분 색인하며, hash 변경 시 최신 active document version+1로 새 문서를 만든다. 74차에서는 로컬 source pack 캐시의 key/lifetime/무효화 경계를 명시해 live turn은 API 프로세스 snapshot을 재사용하고, 관리자 sync/CLI만 refresh=True로 repo 파일을 다시 읽게 했다. 학습자 SessionReview 데스크톱은 요약/흐름, 축어록, 평가 rail의 3열 workbench와 하단 워크시트로 재배치했고, 교수자 검토 화면과 모바일/태블릿은 기존 반응형 규칙을 유지한다.

검증

python -m compileall app -q, 과거 pytest app/test_live_coach_sources.py app/test_orchestrator_masking.py app/test_session_turn_persistence.py -q 27 passed, source sync focused py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_live_coach_sources.py -q 9 passed, H2 related py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_live_coach_sources.py app/test_orchestrator_masking.py app/test_session_turn_persistence.py -q 44 passed, fast-loop failure focused py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_session_turn_persistence.py -k "fast_loop_evaluation" -q 2 passed, failed metric exclusion focused py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_learner_dashboard.py -k "failed_fast_loop" -q 1 passed, py -3.11 -X utf8 scripts\sync-persona-sources.py --help, py -3.11 -X utf8 -m py_compile focused files, npm run generate:api-types, npm run check:api-types, npm run typecheck, npm run build, npm run e2e -- e2e/layout-visual-gate.spec.ts e2e/session-layout.spec.ts 15 passed. 최신 workbench 검증: npm run typecheck, npm run build, npx playwright test e2e/session-review.spec.ts --project=chromium-desktop --workers=1 3 passed, npx playwright test e2e/layout-visual-gate.spec.ts --project=chromium-single-run --workers=1 9 passed, 04-session-review-desktop.png 직접 확인. 로컬 DB smoke: source pack sync 4 sources/15 chunks embedded, 재호출 skipped_unchanged=4, official_suicide_risk_guidelines source filter 검색 성공.

잔여

임상팀 골든셋·라이브 코칭 루브릭 검수, 공식 지침/논문 source pack 추가와 임상 검수 상태 운영정책 보강이 남아 있다.

현재

teacher/admin 전용 /teach/personas는 상단 horizontal tab 기반 워크스페이스다. 대시보드는 공개/활성 페르소나·학습 인원·세션·실제 평가/라포·검수 요약, 카탈로그는 공개 규칙·구성·버전, 페르소나는 검색/필터 table과 내부 검수 현황 탭을 소유한다. 행 상세는 소개·학습 현황·설정 drilldown이며 신규/수정은 자료→초안→설정→검토 단계, 이전/다음 이동, 브라우저+서버 중간 저장을 제공한다. 기존 RAG 자료 등록과 개요/임상/저항/회기/말투/안전/프롬프트 편집, 우측 검증·생성 근거, 승인/반려 결정은 단계형 작업면 안에서 유지한다. 2026-06-28 항목형 목록 UI 정리에서 자동사고, 회기 시나리오, 말투 filler/verbal tic/nonverbal cue, 역린·금기 응답·금기어를 행 추가/삭제 UI로 전환했고, API payload는 기존 배열 schema를 유지하며 빈 항목만 저장 직전에 제거한다. 프롬프트 탭은 raw JSON textarea 대신 L1 카드·인적 범주·임상 배경·말투·수치 파라미터·역린·회기 시나리오·추가 계약 섹션을 라벨형 검토 UI로 보여주며, 런타임 prompt bundle과 API 계약은 변경하지 않는다. 레이아웃 근거는 docs/ops/layout-research-2026-06-27/persona-dashboard-layout-guideline.md에 동기화했다. POST /personas/sources는 첨부/붙여넣기 자료를 PII 마스킹 후 kb.raw_source_artifact에 raw hash-only 격리 증거를 남기고, 별도 sanitized 파생본만 kb.source/document/chunk에 evaluator 전용(visible_to=['evaluator'], sensitivity=2) 근거 문서로 등록한다. POST /personas/drafts/generatesource_id 기반 RAG 검색 결과만 엔진에 넘기고 source/doc/content hash·chunk·prompt bundle provenance를 남긴다. 승인된 카드만 학습자 catalog에 노출되며, 시스템 페르소나와 사용자 생성 페르소나를 구분한다. 공개본 수정은 같은 persona_id의 다음 버전 draft, 삭제는 기존 회기 FK 보존을 위한 archived 전환이다.

검증

현행 재구성: npm run typecheck, npm run build, 페르소나 focused E2E 6 passed, IA·작성 단계 focused 2 passed, layout-visual-gate.spec.ts 14 passed, session-layout.spec.ts desktop/mobile 8 passed, 1440px·390px 대시보드/상세/작성 캡처 직접 확인. 백엔드 RAG·저작·검수 계약은 기존 app/test_persona_generation_contract.py·app/test_persona_review.py 검증을 유지한다.

잔여

암호화 blob/vault 기반 원문 실저장, 임상팀 최종 검수/서면 evidence, 루브릭·이론 콘텐츠 외부화는 후속이다. 임상팀이 제공하지 않은 페르소나 내용을 최종 승인본처럼 확정하지 않는다.

현재

정규식 폴백에 한국어 고위험 패턴 추가: 구체 날짜(2001.4.18→[DATE])·금액(1200원→[MONEY])·행정구역 주소(서울시 강남구 역삼동→[ADDR])에 더해, 이름/성명 라벨·성씨+이름+조사/호칭·대학교/학과/병원/센터 등 suffix 기반 한국어 NAME/ORG 로컬 휴리스틱 1차를 추가했다. 이번 패스에서 app.services.pii_masking_eval, data/privacy/pii-masking-ko-fixtures.json, scripts/evaluate-pii-masking.py를 확장해 합성 fixture 16개로 NAME/ORG/PHONE/EMAIL/RRN/NUMID/DATE/MONEY/ADDR/negative-control을 source/category/severity metadata와 함께 entity recall·forbidden substring removal·unexpected entity violation으로 평가한다. data/privacy/pii-masking-eval-input.schema.jsondata/privacy/pii-masking-eval-report.schema.json은 Node.js 전환 후에도 공유 가능한 입력/리포트 계약이며, 기본 리포트는 evidence_text_included=falsemasked_text/forbidden_remaining 원문 증거를 제외한다. fixture가 잡은 소속/안내/이름진로는 NAME 오탐은 보정했고, 66차에서는 자연 발화형 이름 라벨·자기소개 케이스를 추가해 라벨 단어만 마스킹하고 실명을 남기던 구멍을 막았다. Presidio가 설치돼도 한국어 누락을 막기 위해 regex fallback을 후단에 한 번 더 태운다. 70차에서는 guardrail.mask_pii() 내부에 선택형 한국어 PII recognizer adapter 경계를 추가했다. adapter는 명시 등록 전에는 비활성이고, 실패해도 예외를 밖으로 내보내지 않으며, fake adapter 테스트가 adapter span 마스킹 뒤 후단 regex fallback이 전화번호를 계속 처리하는지 고정한다. 상담 생성(generate/stream)·fast/deep 평가의 외부 LLM 호출 직후 audit.llm_call_log에 provider/model/token/cost/inference_geo/latency만 적재한다. prompt/completion 본문은 저장하지 않는다. fast evaluator prompt의 내담자 응답과 DB에 저장되는 client turn text_masked도 마스킹본을 쓰게 보강했다. 로컬 dev-login 실제 /turn smoke에서 audit.llm_call_log가 8→11로 3행 증가했다. 이번 패스에서 app_user에 이름·소속·학과·학년/직위·연락처·주소/수령지·닉네임·자기소개·아바타 URL·약관/개인정보 동의 시각·버전을 추가했다. 로그인 후 onboarding_completed_at이 없으면 전역 OnboardingGate/onboarding 외 URL(/learn, /settings, /admin, /dev/avatar-preview, /login 포함)을 모두 온보딩으로 돌리고, 온보딩 중에는 공용 셸 메뉴 없이 가입 직후 사용자 정보 입력 폼만 보여준다. learner 회기 시작도 온보딩 완료 전에는 막는다. /users/me/avatar는 PNG/JPG/WebP MIME·시그니처·3MB 제한 후 파일을 USER_UPLOAD_DIR/profile-avatars에 저장하고 URL만 보관한다. 약관·개인정보 처리방침 초안은 /users/legal-docs에서 제공한다. 관리자/교수자 권한은 온보딩에서 받지 않고 allowlist/관리자 사용자 관리로만 부여한다. 검증: py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_pii_masking_eval.py app/test_orchestrator_masking.py app/test_evaluation_persistence.py app/test_session_turn_persistence.py -q 47 passed, py -3.11 -X utf8 scripts/evaluate-pii-masking.py --json 16/16 pass, 최신 보정 검증 py -3.11 -X utf8 -m pytest app/test_orchestrator_masking.py app/test_pii_masking_eval.py app/test_session_turn_persistence.py app/test_voice_ws.py -q 59 passed, py -3.11 -X utf8 -m py_compile apps/api/app/services/guardrail.py apps/api/app/services/pii_masking_eval.py apps/api/app/test_pii_masking_eval.py apps/api/app/test_orchestrator_masking.py scripts/evaluate-pii-masking.py, 과거 온보딩/동의 검증은 pytest app/ -q 178 passed, pytest engine_gateway/ -q 11 passed, npm run check:api-types, npm run typecheck, npm run build, auth E2E 7 passed, 최종 PLAYWRIGHT_PORT=5174 npm run e2e 113 passed.

잔여

한국어 이름/기관과 contact/national/quasi-identifier 합성 technical dry-run은 16-case summary-only harness 및 선택형 ko recognizer adapter 배선 회귀까지 완료했지만, 실제 운영 모델/provider 선정, 운영 말뭉치 기반 오탐/미탐 평가, 미성년/guardian 및 법무 검토가 필요한 최종 서명 동의서·개인정보 처리방침·약관 evidence는 외부/후속 게이트다. 공개 Google OAuth 실제 /turn proof는 별도 운영 게이트.

현재

M1: voice learner turn의 audio_ref, silence_ms, speech_rate, barge_in을 리뷰 API nonverbal 이벤트로 파생하고, 회기 리뷰 축어록에 침묵·발화 속도·끼어듦·음성 입력 칩으로 표시한다. 2차로 provider_events JSONB 보존 슬롯을 추가해 control/STT provider 이벤트를 allowlist·size limit 후 저장한다. 3차에서는 저장 이벤트에 내부 taxonomy event_type/category를 추가해 sigh/cry/laugh/voice_activity/noise 등 canonical key를 남긴다. 4차에서는 인증된 회기 리뷰에 한숨·울음·웃음·호흡·운율·배경소음 계열만 한글 label/detail 칩으로 파생 노출한다. raw transcript/text payload, provider/source/raw type, 공개 공유 카드 노출은 제외했다. 실제 provider 기반 한숨·울음 감지와 live 마이크/WSS 장시간 실측은 아직 별도다. M2: case_profile을 learner-persona 안정 case로 upsert하고, session_no를 트랜잭션 안에서 원자 증가시킨다. 세션 종료 시 마스킹된 client-visible 축어록으로 fallback session_summary.digest와 case-level case_digest를 갱신하고, rapport_trajectory/alliance_level을 결정론 상태 수치에서 갱신한다. 종료 시점에는 마스킹된 client-visible 발화에서 [NAME]/[ORG] identity와 명시적 상담 약속만 pinned_fact로 upsert한다. 삽입 또는 값 변경 시에는 pinned_fact_history에 append-only 이력을 남기고, 같은 값 재확인과 locked fact는 이력을 늘리지 않는다. 5차에서는 명시적 상담 약속 철회/부정 문장만 기존 non-locked agreement:counseling fact를 contradicted로 격리하고 history reason contradiction을 남긴다. 새 contradicted fact를 임의 생성하거나 관계갈등·위기·임상 추론을 자동 모순 처리하지 않는다. 6차에서는 종료 저장 성공 뒤 background task로 마스킹된 client-visible 내담자 발화만 app.turn_embedding에 idempotent 색인한다. 7차에서는 시작 경로가 seed recall을 cache에 적재하고, REST submit/SSE stream은 공통 _prepare_turn_context()에서 recall, pinned fact, 최근 client-visible 턴, KB cue를 TurnContext/EngineMessage로 조립한다. route-level 테스트는 DB case_digest·직전 session_summary·client-visible pinned_fact가 다음 턴 L2/L4 블록에 들어가고 raw 이름이 [NAME]으로 마스킹되는지 고정한다. 76차에서는 SessionDigestInput/SessionDigestResult/SessionSummaryWrite로 종료 digest 입력·fallback 결과·DB write 인자 경계를 명시했다. 94차에서는 DigestQualityAssessment/SessionDigestWorkerOutcome로 LLM digest 후보의 local quality harness를 추가해 빈/짧은 digest, raw forbidden substring, 내부 평가·CCD·상태 marker, 잘못된 세션 prefix를 fallback 유지 대상으로 판정한다. 95차에서는 session_digest_worker.pyCompressionJobGenerateRequest 변환, 주입형 engine/audit 호출, accepted-only session_summary/case_profile 적용 계획과 one-shot DB loader를 소유하게 했다. 96차에서는 scripts/run-session-digest-worker.py가 명시 session id dry-run/apply runner를 제공한다. 97차에서는 SESSION_DIGEST_WORKER_ENABLED=false 기본값의 세션 종료 scheduler 골격과 compressed_by IS NULL loader/apply CAS를 추가했다. 입력 후보는 client-visible masked turn과 open thread만 받으며, 종료 상태 수치·평가 payload·CCD·raw text는 압축 prompt에 넣지 않는다. digest_pending은 CompressionJob 생성 여부 신호로 유지한다. M3: Google/SAML/dev-login이 AUTH_EMAIL_COHORT_MAP/AUTH_DOMAIN_COHORT_MAP 및 SAML cohort claim을 cohort_ids로 전달하고, DB app_user.external_id는 provider subject(google:/saml:/dev:) 기반으로 저장한다.

권고

M1 실제 provider 기반 한숨·울음/억양 감지, 장시간 마이크/WSS 실측과 역량 지표화 정책, M2 관계/임상 fact 승격 기준·실 provider 장시간 운영·임상 골든셋 품질평가·재압축, M3 운영 SAML 서명검증·기관 claim schema/test tenant·deprovisioning audit는 후속이다.

현재

X1: scripts/export-recursive-dataset.pyapp.services.dataset_export로 masked-text JSONL dry-run, PII scan, κ/ICC 계산, approved export 게이트를 구현했다. exporter는 동의가 남아 있고 learner-visible인 text_masked 턴만 선별하며, supervisor comment raw text는 JSONL에 넣지 않는다. artifact checker는 approved/dry-run JSONL의 필수 key·row count·privacy·PII shape를 검사한다. 기본은 technical_dry_run이고 ds.* write는 --write-dataset 명시 시에만 수행한다. X2: app.turns의 provider/model/tokens/cost를 최근 7일 기준으로 집계하는 GET /admin/usage를 추가했고, 운영 콘솔 /admin에 누적 비용·입출력 토큰·계량 커버리지·provider/model breakdown, 일별 daily_cost 추이, ADMIN_USAGE_BUDGET_USD 기반 예산 경고(ok/warn/exceeded)를 표시한다. EVALUATOR_FAST_MODEL/EVALUATOR_DEEP_MODEL 설정 시 fast/deep 평가 호출만 해당 모델 override로 gateway에 전달하고, 비워두면 기존 default 라우팅을 유지한다. fast/deep evaluator structured 결과는 canonical request SHA-256 키의 인메모리 semantic cache로 재사용한다. 캐시는 EVALUATOR_SEMANTIC_CACHE_ENABLED, EVALUATOR_SEMANTIC_CACHE_TTL_SECONDS, EVALUATOR_SEMANTIC_CACHE_MAX_ENTRIES로 제한하며, 원문 prompt·completion은 저장하지 않고 성공 파싱 결과만 캐시한다. /admin/usage는 evaluator cache enabled/entries/hits/misses/stores/evictions/requests/hit_rate도 함께 반환하고, 관리자 AI 비용 카드가 hit-rate와 일별 비용/턴 추이를 표시한다. app.services.usage_reportscripts/report-ai-usage.py는 같은 usage JSON에서 provider/model별 cost share, token share, cost/turn, cost/1k tokens, budget/cache warning을 산출한다. DB 미가용 dev에서는 runtime store로 fallback하지만 prod에서는 fail-closed한다. L1: 소유자 결정으로 Node.js 우선 교체 가능성 방향을 채택했다. docs/decisions/backend-node-transition.md에 FastAPI 유지 사유와 strangler 전환 원칙을 기록했고, app/contracts/engine_gateway.py를 추가해 Python client와 현재 gateway가 같은 요청/응답/SSE 계약을 공유한다. 이어서 EngineClient.stream_packets()와 gateway GenerateResponse 반환으로 서비스 레이어의 wire-format 의존을 줄였다. engine_gateway_contract.v1.json golden fixture와 engine_gateway_schema.v1.json schema artifact로 generate request/response와 stream token/done/error packet을 고정했고, scripts/check-engine-gateway-contract.mjs가 같은 artifact를 Node.js에서 Python import 없이 검증한다. 78차에서는 gateway-default 기본 라우팅 sentinel과 모델 override 정규화를 같은 계약 모듈로 올려 FastAPI client, Python gateway, stream audit/done fallback, 관리자 기본 config가 같은 의미를 공유하게 했다. 79차에서는 structured_payload_from_response()가 structured field 우선, fenced JSON, embedded JSON object fallback을 소유해 evaluator/live-coach/persona draft의 legacy generate response 해석을 같은 계약 경계로 모았다. 80차에서는 app/persona_generation_contract.py가 persona draft schema, prompt bundle, payload extraction, generated draft coercion을 소유하게 했고, 81차/89차에서는 evaluator/live-coach가 structured payload 계약 helper를 직접 호출하며 SessionEvaluationWrite.from_result()/from_error()가 session evaluation write packet 생성을 소유하게 했다. app/session_read_model.py는 세션 목록·대시보드·상세·리뷰·공유 payload의 DTO와 builder를 route에서 분리했고, app/persona_read_model.py는 페르소나 catalog/review/draft/source/evidence DTO와 mapper를 route에서 분리했다. 각 route는 auth/RLS DB read/persistence/RAG/LLM side effect를 유지한다.

권고

X1 approved export·골든셋 승격은 steward/legal 승인, reviewer disposition, IAA 게이트(κ≥0.70/ICC≥0.75) 이후만 진행한다. X2 후속은 자동 차단·한도 enforcement 정책이다. L1의 남은 게이트는 신청서/저작권 등재 문서에 FastAPI 유지 사유와 Node 전환 계획을 반영하는 외부 거버넌스 증거다. H3 항목형 목록 저작 UI와 프롬프트 미리보기 de-JSON은 60~61차에서 처리됐다. 실제 운영 말뭉치 기반 H4 평가는 외부 데이터·reviewer 정답 라벨·법무/guardian evidence 전까지 gate로 남기고, 내부 후보였던 합성 fixture 확장과 운영 평가 입력/report schema 준비는 62차에서 technical_dry_run으로 완료했고, 실제 운영 평가는 여전히 gate다.

즉시 착수 가능(내부 코드, 외부 합의 불요)

  • C1은 저장형 워크시트와 외부 루브릭 schema/loader/validation scaffold까지 3차 완료. C2는 1차 구조 완료, C3은 이론모드 배선과 명시 선택 UI까지 2차 완료했고 수동 session/turn 재평가도 세션의 theory_mode를 우선하도록 회귀화했다. H2는 라이브 코칭 1차와 source pack version sync 및 학습자 리뷰 3열 workbench, H3은 페르소나 저작 CRUD/RAG 생성/seed materializer runner/source pack sync runner/raw source hash-only isolation/항목형 목록 저작 UI/프롬프트 미리보기 de-JSON까지 완료. 후속은 임상 스크립트, CBT 체인, 루브릭·이론 콘텐츠 외부화처럼 데이터·정책 고도화 영역이다.
  • H4(부분): 한국어 날짜/금액/주소 및 이름/기관 로컬 휴리스틱 마스킹, 16-case 합성 fixture 평가 harness와 입력/report schema, metadata-only LLM call audit 경로, 로컬 live row proof, learner 동의 수락/철회/회기 시작 하드게이트 골격은 완료. 실제 운영 말뭉치 기반 오탐/미탐 평가는 외부 데이터·reviewer 라벨·법무/guardian evidence가 필요하므로 gate로 남긴다. 내부 후보였던 합성 fixture 확장과 운영 평가 입력/report schema·summary-only dry-run 준비는 62차에서 완료했고, 자연 발화형 이름 누수 보강은 66차에서 완료했다. 70차에서는 선택형 ko recognizer adapter 인터페이스와 fake/failure 회귀를 추가해, 실제 모델/provider를 고르기 전에도 같은 mask_pii() 경계에서 adapter→regex fallback 순서를 검증할 수 있게 했다. X1 dry-run export 1차와 X2 비용 관측·예산 경고/evaluator 모델 override·semantic cache·hit-rate 관측·일별 비용 추이·모델별 비용 검증 리포트는 완료했고, 자동 차단·한도 enforcement는 정책 결정 전까지 보류한다. M1 provider_events 보존·taxonomy·인증 리뷰 파생 칩 4차, M2 case memory+pinned_fact 보수적 실적재·append-only history·명시적 상담약속 철회 contradiction·episodic embedding writer·다음턴 주입회귀 7차/digest contract + local quality harness + one-shot worker/runner/default-off scheduler 경계, M3 claim 1차, L1 schema-backed engine gateway golden fixture·default-routing sentinel·structured payload parser·Node.js conformance runner·session/persona read-model 분리는 완료. 운영 SAML 서명검증은 기관 IdP 의존이다.

소유자 결정 / 외부(임상팀·기관) 의존

  • 임상팀 산출물: C1 루브릭 항목·척도·가중치·anchor 예시·컷오프·검수 기준, C3 CBT 콘텐츠·체인, C2 위기 스크립트·서약 문안, H2 골든셋 코딩.
  • 소유자 평가설계: H1 실험/통제군·3척도 문항·50분 흐름, κ/ICC·환각률 목표(doc4 미명시).
  • 기관(한신 IT): M3 SSO IdP·test tenant·claim 스키마·인증서, 거버넌스 증거.
  • 거버넌스: L1 Node 전환 방향은 결정됨. 남은 것은 FastAPI 유지 사유와 계약 우선 전환 계획의 저작권 등재 문서화·IP 협의.

판독 한계 (정직성)

  • 핵심 축어록 2단 표는 PDF 시각 판독이 1차 근거(txt 일부 누락), OCR 잔재 존재.
  • doc4 κ/ICC·환각률은 신청서 본문 미명시 — 계약 확정 지표로 단정 금지.
  • '현재상태'는 grep/코드 사실 기반에서 시작했으나 C1·C2·C3 2차 UI·H1~H4·M1 provider_events 보존/taxonomy/인증 리뷰 파생 노출·M2 case memory/pinned_fact/history/명시철회 contradiction/episodic embedding writer/digest contract/local quality harness/one-shot worker/runner/default-off scheduler boundary·M3·X1·X2·L1 Node conformance/default-routing sentinel와 session/persona read-model 분리는 구현 후 재검증 완료 기준이다. M2는 fallback digest, digest_pending 응답 계약, LLM 후보 local quality harness, accepted-only one-shot worker/runner/default-off scheduler 경계까지이며, 실 provider 장시간 운영·임상 골든셋 품질평가·재압축은 완료로 보지 않는다. H3 원문 격리는 hash-only artifact와 RAG index 차단까지이며, 암호화 blob/vault 원문 실저장은 아직 후속이다. 실제 provider 기반 한숨·울음 감지, H4 legal/guardian evidence, M3 운영 IdP, L1 외부 거버넌스는 아직 게이트다.

코드품질 · 로컬 개발 스택

리팩토링 연구 + 1-커맨드 dev 스택 (2026-06-26~27). code-quality-research-2026-06-26.md · local-development.md
공개 전환

2026-08-07 18:26 KST owner 승인으로 vignette_recovered_prod_20260807vignette-dev-db:55432에 연결했다. cutover 집계 users 84·sessions 30·turns 705, Google 계정 16·소유 회기 30, orphan 0이다. 2026-08-09 Docker Desktop 중단 후 동일 컨테이너만 재기동했고, fresh dump f1fd569c…5f64를 보존한 뒤 누락 migration 14만 단일 트랜잭션으로 적용했다. 현재 local/public health는 prod·DB true·engine true·claude_cli, OpenAPI 126, Google OAuth 302다. API/cloudflared와 watchdog·로그온 task는 detached-clean a73bcd24…·tree b02b3a1b…와 exact script SHA에 pin했고 두 task 명시 실행 결과 0·Ready를 확인했다. 실제 Windows 재부팅 smoke만 남아 있다.

보존·rollback

전환 직전 DB는 vignette-dev-db-pre-recovery-20260807-182642로 중지 보존했고 exact dump SHA는 6b84d5c8…8af1f다. 원본 volume, post-merge dump d24eaa75…2e32, 최종 recovered dump d7bcc396…68ed, 2026-08-09 fresh dump f1fd569c…5f64, 자동 rollback을 실증한 실패 후보 2개도 삭제하지 않았다.

사용자 확인

보안상 기존 auth_session은 복사하지 않아 모두 Google 재로그인이 필요하다. 계정·회기 원장은 복구돼 있다. 실제 사용자가 재로그인한 뒤 과거 소유 회기 목록이 보이는지 확인할 때까지 이 카드는 안정화 중으로 유지한다. 상세: ops/public-db-recovery-rehearsal-2026-08-07.md.

현재

게이트웨이(9099 claude_cli)+API(8000)+웹(5173)을 결정론적으로 기동한다. DB는 이름만 같은 새 container로 바꾸지 않는다. 기존 container가 stopped이면 docker start와 readiness를 먼저 수행하고, 그 외 비정상 상태·시작 실패·readiness timeout은 container/volume을 보존한 채 fail closed한다. 신규 DB만 vignette-dev-db-pgdata named volume을 사용하며 일반 경로에는 container rm·volume rm/prune·compose down -v가 없다.

검증

scripts/test_dev_up_db_safety.py 5 passed, Ruff, Windows PowerShell 5.1 AST parser, diff check 통과. 실행 중인 DB container ID·생성 시각·PGDATA volume은 테스트 전후 동일했다.

현재

직접 WS 재현으로 근본원인 규명: 키 없으면 백엔드가 degraded+1011 즉시 close → 마이크 깜빡·녹음 미도달. 현재 로컬 /voice/healthavailable:true이고, 실제 P2 회기에서 MP3 발화를 /voice/ws로 보내 STT transcript 52자 → client reply 105자 → TTS 바이너리 66 chunks/266,496 bytes를 수신했다. 이 증거는 로컬 캐스케이드 검증이며, 물리 마이크·public WSS·50분 장시간 실측 완료를 뜻하지 않는다.

부수 수정

① 미설정 시 마이크 버튼 사전 비활성+명확 안내 ② TTS 지문 제거: (고개 끄덕)·(한숨)·[침묵] 등 무대지시를 음성으로 안 읽음(speakable_text, 자막엔 유지) ③ 아바타 애니메이션: 텍스트 턴 speaking 시 입 정지(0) 버그 수정 + thinking 표현 보강 ④ 브라우저 자동재생 차단 대응: 마이크 클릭 시 AudioContext.resume()으로 unlock하고 TTS Blob을 Web Audio buffer source로 재생, 실패 시 기존 <audio> fallback ⑤ AudioWorklet-first PCM16 capture와 EOT stt_result route wiring. typecheck+voice테스트+voice E2E+local live WS smoke PASS.

증상

라이브 회기에서 내담자(민재)가 "저는 Claude Code인데… Vignette 코드베이스… git status…"로 캐릭터를 깨고 개발 맥락 노출. 원인: ENGINE_MODE=claude_cli가 로컬 claude(=Claude Code)를 호출하는데 게이트웨이가 페르소나를 --append-system-prompt로 코딩 어시스턴트 정체성에 덧붙이고, cwd=repo라 CLAUDE.md·git status·env가 시스템프롬프트에 포함됨.

수정·검증

engine_gateway/gateway.py: --append-system-prompt--system-prompt(페르소나만 교체 주입) + --exclude-dynamic-system-prompt-sections(cwd/env/git/메모리 섹션 제거). 라이브: 깨던 입력 그대로 → 민재 완벽 인캐릭터, 누출 0. 게이트웨이 11 passed + 전체 API 178 passed.

현재

app/turn_runtime.py를 추가해 load_owned_session, record_completed_turn, append_completed_turn, update_session_state, record_safety_event를 공통화했다. 이번 패스에서 finalize_completed_turn을 추가해 record_completed_turn + record_safety_event 호출쌍을 REST submit/stream과 voice WS 라우트에서 제거했다. stream fast-loop 평가 누락, voice 세션 recall cache, visible_to/evaluator turn 분리는 보존.

검증

pytest app/test_session_turn_persistence.py app/test_voice_ws.py engine_gateway/test_gateway_model.py app/test_phase3_artifact_checker.py app/test_dataset_export.py -q 40 passed.

잔여

더 큰 finalize_turn/SessionRepository 경계, 장기적으로는 세션 저장소 인터페이스 SSOT화가 남아 있다.

현재

apps/api/scripts/export-openapi.pyapps/web/scripts/generate-api-types.mjs로 FastAPI OpenAPI를 apps/web/src/lib/api.gen.ts에 생성한다. npm run check:api-types가 재생성 누락을 잡는다. MeResponse, AuthConfigResponse, ConsentResponse, PersonaSummary, PersonaReviewSummary, admin/user/engine DTO, review leaf DTO, CrisisResourceResponse, teacher safety/growth leaf DTO, LearnerSessionsResponse, LearnerDashboardResponse, SessionReviewResponse, worksheet aggregate, TeacherDashboardResponse, TeacherSessionSummary, TeacherLearnerGrowth에 이어 SessionStartResponse, SessionDetailResponse, SessionDetailTurnApiSchema<...> alias로 전환했다. 세션 응답 stage는 backend StageLabel enum으로 고정해 OpenAPI가 라포|탐색|개입|정리 union을 생성한다. 69차에서는 리뷰 도식 ReviewPhaseSegment.keyrapport|explore|intervene|closing, ReviewPhaseSegment.labelSessionReviewResponse.reachedPhaseStageLabel로 좁혔다. 평가 조회 EvaluationSummary.stage는 평가 미생성 시 null, 평가 트리거 응답 stage와 교수 콘솔 TeacherSessionSummary/TeacherGrowthPoint stage는 StageLabel union으로 생성된다. 71차에서는 공개 공유 응답 PublicSessionShareResponse.reachedPhase와 live-coach 이력 LiveCoachEvent.stageStageLabel | null 계약으로 축소했다. 72차에서는 app/stage_contract.pyStageLabel, ReviewPhaseKey, legacy stage code 정규화, unknown→null 판단, 리뷰 phase key 매핑을 소유하게 해 turn_runtime.py, session_read_model.py, routes/eval.py의 중복 규칙을 제거했다. generated optional/default 차이는 화면 form state, notification default helper, 배열 렌더링 fallback, live-coach 단계 미상 표시로 흡수한다. .github/workflows/api-contract.yml은 PR/master push에서 같은 stale check를 실행해 OpenAPI type drift를 CI에서 막는다.

검증

py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_evaluation_persistence.py app/test_evaluator_model_routing.py app/test_teacher_dashboard.py app/test_rbac_idor.py app/test_session_turn_persistence.py -q 50 passed. 공유/live-coach 후속 검증: py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_session_share.py app/test_live_coach_sources.py app/test_session_turn_persistence.py app/test_orchestrator_masking.py -q 43 passed. Stage contract SSOT 검증: py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_stage_contract.py app/test_session_share.py app/test_session_turn_persistence.py app/test_evaluation_persistence.py app/test_teacher_dashboard.py -q 42 passed. py -3.11 -X utf8 -m py_compile apps/api/app/stage_contract.py apps/api/app/turn_runtime.py apps/api/app/session_read_model.py apps/api/app/routes/eval.py apps/api/app/routes/sessions.py apps/api/app/routes/share.py apps/api/app/services/live_coach.py, npm run check:api-types, npm run typecheck, npm run build passed. 과거 영향 범위 E2E: learner.spec.ts + session-review.spec.ts + teacher.spec.ts + layout-visual-gate.spec.ts 32 passed.

잔여

남은 자유 문자열 stage는 evaluator 내부 payload, DB 저장 컬럼, dataset export, runtime store 같은 저장·분석 payload다. 라벨/phase key 변환 규칙은 app/stage_contract.py 하나로 이동했고, 브라우저-facing OpenAPI 응답 stage 계약은 현재 확인된 session/review/eval/teacher/share/live-coach 표면에서 enum/null로 고정했다.

현재

apps/web/index.html에 canonical, description, Open Graph/Twitter Card, JSON-LD(WebApplication)를 추가했고, public/robots.txt, sitemap.xml, llms.txt로 공개 사이트와 AI 검색용 설명을 정리했다. 인증 내부 경로는 robots에서 차단한다. 학습자 회기 리뷰는 종료 후 POST /sessions/{id}/share로 공개 토큰을 만들고, GET /share/session/{token}이 서버 렌더 HTML/OG/JSON-LD를 반환한다. app.session_share_link에는 토큰 해시와 sanitized preview payload만 저장하며 원문 축어록·학습자 식별자는 저장하지 않는다.

검증

pytest app/test_session_share.py app/test_session_turn_persistence.py -q 21 passed, python -m pytest app/ -q 178 passed, python -m pytest engine_gateway/ -q 11 passed, npm run check:api-types, npm run typecheck, npm run build passed.

판정

공개 제품 페이지는 색인 가능, 회기 공유 페이지는 교수자 전달용 unfurl 카드라 noindex와 API robots Disallow: /share/를 유지한다. 실제 공개 도메인 unfurl 검증은 배포 후 1회 필요하다.

현재

LogHook/log_hook(caller 0) 타입·파라미터·분기·export 제거 · 게이트웨이/엔진클라 tier dead-contract 제거(write-only, gateway는 model만 사용). 잔여(RMS 힌트·Live2D 고아 자산·파라미터객체 init_state/prepare_turn/upsert)는 docs/archive/ops/refactor-rag-patches-2026-06-26.{md,json}에 스테이징(단계 적용).

참고

일괄 적용 대신 라이브 스택 보호 위해 그룹별 적용+pytest 검증.

현재

임베더 BGE-M3 검증+버전핀(1.4.0 dtype버그→1.2.11/transformers 4.44.2). embed_query를 asyncio.to_thread로 offload. 턴 파이프라인 배선: retrieve_persona_memory→episodic recall, search_kb→kb_behavior_cues. KB seed 3청크 적재. rag.py latent 버그 3건 수정. GraphRAG는 2차 보류.

성능 회귀 수정

최초 RAG 배선이 회기 시작/턴에 임베더 로드(~7-13s)를 동기 awaitPOST /sessions가 막힘 → session-layout E2E 4건 타임아웃. 수정: 회상·KB 회수를 _warm_rag_caches 백그라운드 task로 옮기고 턴은 캐시만 읽음(비차단). 이번 동의 게이트 E2E 재검증 중 여러 세션 warm task가 BGE-M3를 동시에 지연 로드해 API health/dev-login timeout이 반복된 문제는 embedder load/encode RLock과 warm semaphore 1개로 안정화했다. 재검증: session-layout 4/4 + 핵심 E2E 27/27·11/11·아바타 4/4, 최신 layout/session 조합 11/11 통과.

시각 게이트

admin 1280 input "text-clipped-x" 1건은 폼 input 값 스크롤(설계상 정상) 오탐 — form 컨트롤을 text-clip 판정에서 제외했다. 당시 게이트는 7/7, 현재 strict gate는 빈 회기리뷰 포함 9/9다.

Outcome & Alliance OS · 정식 승격 로드맵

제약이 아닌 증거 게이트로 진행 · 사람 개발자 계획 없음 · 2026-08-06 승격
구현

app.measurement_event·app.measurement_instrument·audit.model_run과 6종 provenance, Python→JSON Schema→TypeScript 계약, 기존 rapport/alliance/fast/deep/Phase 3 adapter, 혼합층 집계 차단, 8개 deterministic benchmark 장면을 구축했다. AOS-001~004 완료.

종료 증거

post-merge dump disposable clone에 migrations 14/15/16을 각각 두 번 원자 재적용했다. current source census는 producer 29/29, unknown/missing table·null instrument/source/perspective·orphan instrument/model-run/evidence·호환성 위반 0이다. 기존 계약/schema·live append-only/RLS 증거도 유지한다. 상세: ops/evidence/g0-provenance-census-scratch-post-g6-g8-20260807.json, ops/evidence/measurement-migration-rehearsal-2026-08-07.json.

구현

회기 pulse, legacy alliance 격리, 자기평가 선잠금, 독립 모델 실행·재시도, 학습자 관점차 리뷰, 교수자 append-only 재평가를 구축했다. 실제 Session은 첫 발화 전 pre를 fail-closed로 잠그고 첫 왕복 뒤 흐름을 막지 않는 mid 30초 점검을 제공한다. AOS-005~010 완료.

종료 증거

focused backend 43 passed, live PostgreSQL reveal/RLS/audit/supersession smoke, desktop/mobile Alliance Pulse 6/6와 기존 회기 리뷰 12/12 통과. 동일 payload stable ID, 변경 payload 409, 타 학습자·교차 cohort 404와 pre/mid desktop·mobile 2/2·고정 캡처 4장을 추가 검증했다. 최신 source API/dev DB는 한 회기의 pre(degraded/insufficient_transcript) → mid(ready) → post(ready)를 실제 turn UUID·ended_at으로 닫고, awaiting 응답의 external-event read skew와 degraded terminal DB 제약을 교정했다. prompt 1.2.0 read-skew 재검증은 prediction 24/24 ready·비교 대상 9/9·방향 9/9·오류 0, 근거 recall 94.4%·precision 73.9%다. 상세: ops/evidence/alliance-calibration-comparison-prompt-1.2.0-readskewfix-2026-08-07.json, ops/evidence/alliance-pulse-pre-mid-post-live-2026-08-07.json.

구현

교육용 합성 5회기 arc, 세 축 outcome 원장·append-only revision, 누락·오류 무점수, safety 분리, early warning·다음 질문, 역할별 관계 기억, 학습자 체크인과 desktop/mobile 타임라인을 구축했다.

종료 증거

4-case×5-session benchmark status 정확도 1.0·false alert/critical miss 0. 기존 실제 DB/API on-track case의 S1~S5·관측 15개·멱등/409·RLS·role-safe 기억에 더해, production measurement producer→store→evaluator를 통과하는 실제 PostgreSQL 두 case·10회기·30개 측정으로 악화 on_track→off_track→deteriorating과 단발성 noise on_track→watch→on_track·alert 승격 0건을 검증했다. case별 revision 5개와 learner/teacher projection 일치, 합성·비임상 표시를 보존했다. G2 focused 40 passed, 전체 API 855 passed, G2 UI 12/12, G1+기존 리뷰 15/15. 상세: ops/outcome-trajectory-live-integration-evidence-2026-08-06.md, ops/evidence/outcome-trajectory-alerts-live-2026-08-07.json.

구현

9종 rupture/repair 상태머신·append-only 원장, Scenario Director, 텍스트·SSE·음성 공통 finalizer 감지 경계, 회기 후 근거 장면·복구 분기, fast/deep reconciliation, 교수자 supersession을 구축했다.

종료 증거

11-case benchmark macro-F1 1.0·복구 상태 accuracy 1.0, critical miss·judge gaming·암기문구 false resolution 0. Scenario/G3 107 passed, 통합 계약 251 passed, 리뷰 desktop/mobile 50/50. 기존 수동 write API 계약과 별도로 실제 텍스트 submit_turn·공용 finalizer callback만 사용한 PostgreSQL smoke가 missed·partial·resolved 3 episode, 10개 append-only observation, 3개 reconciliation, learner/teacher projection, 세션 밖 evidence 참조 0건을 통과했다. SSE·음성 개별 transport 실 DB smoke는 이 증거 범위가 아니다. 상세: ops/rupture-repair-live-integration-evidence-2026-08-06.md, ops/evidence/rupture-runtime-auto-live-2026-08-07.json.

구현

원자적 practice prescription, 5개 연습 모드, competency graph·attempt evidence, 약점/망각 우선 선택, append-only PostgreSQL/API·RLS·내부 토큰, 학습자/교수자 리뷰 UI를 연결했다. ready 회기말 평가 저장 뒤 production session_learning_producer가 durable turn intent deviation을 실제 처방으로 변환한다. 학습자 CTA는 처방·원본 회기·성공 기준을 학습 홈→시작 전 브리핑→실제 새 세션 URL까지 보존한다.

종료 증거

실제 API/DB/엔진 smoke는 prescriptions 2·episodes 6·attempts 6·append-only correction 1·ready observer model-run 2를 통과했다. post-merge disposable clone의 실제 브라우저는 route mock 0으로 desktop 2/2·mobile 2/2, returned 카드 우선·G4 POST·read-model reload·before/after·멱등 retry를 확인했고 최종 episode/attempt/ready observer 각 1, 중복·UUID 노출·마이크 호출·overflow 0이다. 전체 API 현재 921 passed. 상세: ops/evidence/scratch-browser-returned-practice-closed-loop-evidence-20260807.json, ops/outcome-os-g4-g5-production-caller-evidence-2026-08-07.md.

구현

prediction revision/lock/reveal, 독립 수행 관측, calibration error·95% interval·메타인지 처방, 미지 transfer suite·암기 차단·합성 drift 원장/API/RLS와 역할 안전 UI를 연결했다. production lock callback은 ready 평가와 같은 competency의 durable turn evidence가 있을 때만 failed 독립 관찰을 파생하며 pass·mastery·transfer는 자동 추론하지 않는다. 실패한 unseen trial과 자기보정 처방을 학습 홈과 실제 새 세션까지 보존한다.

종료 증거

실제 API/DB/엔진 smoke는 execution·model-inferred·independent observer·instrument v1·durable evidence·distinct model-run을 각각 1로 고정하고 멱등 및 오류 출처·미종료·타학습자·교차 cohort 차단을 통과했다. post-merge disposable clone 브라우저는 route mock 0으로 desktop/mobile 4/4, actual POST→read reload→before/after와 1→1 멱등 재확인을 통과했고 UUID 노출·마이크 호출·중복 원장 0이다. 4-case benchmark와 lock/reveal/RLS 계약도 유지한다. 상세: ops/evidence/scratch-browser-returned-practice-closed-loop-evidence-20260807.json, ops/calibration-transfer-live-integration-evidence-2026-08-06.md.

구현

append-only attention queue·원장 pointer, metadata-only 교수자/AI 불일치 dataset·audit, cohort gap, version/subgroup drift, 4-domain Phase 3 manifest와 역할 안전 교수자·연구 UX를 연결했다. scheduled producer가 G0~G5 실제 원장에서 attention/gap을 파생하고 repo-approved synthetic version comparison을 별도 research 트랜잭션으로 실행한다.

종료 증거

기존 6-signal queue·3-click·네 도메인 manifest·실제 API/DB/RLS/audit·version/subgroup 증거에 더해 post-merge disposable clone의 current source에서 safety event와 deterioration 경쟁 신호를 실제 derive했다. 결과는 safety_boundary(1) > deterioration(2), direct pointer 각 1, source detail canary 1·G6 projection canary 0, raw transcript/임상 주장 0이고 replay가 멱등이다. 상세: ops/evidence/g6-safety-priority-runtime-scratch-20260807.json, ops/outcome-os-g6-version-comparison-producer-evidence-2026-08-07.md.

내부 구현·공개 선행조건 DONE

consent→단일 clock→독립 text/voice/fusion→철회·tombstone, streaming interim/final·word timestamp·provider event, HMAC word pseudonym, 열린 stream의 1초 동의 재검사·abort, 텍스트 보존·음성 재연결 UX를 연결했다. 운영 기본 provider는 노트북 상주 local_whisper/melotts이고 외부 Deepgram/OpenAI adapter는 fallback으로 보존한다. 격리 synthetic PCM soak는 59/59를 통과했다. Windows host topology는 detached-clean commit/tree·도구 SHA·psutil version과 PID/start/exe·command SHA/cwd·process/TCP high-water를 fail-closed로 수집하고, 3,120초 capture의 공통 3,000초를 canonical exit와 결속한다. 공개 API/cloudflared는 clean a73bcd24…·tree b02b3a1b…로 fresh 승격돼 OpenAPI 126·/admin/voice-runtime·local_whisper/small·melotts/melotts-korean·WS queue 4를 제공한다. receipt 47388d58…9b08가 passed이고 두 source-pinned task도 result 0이다. human pack은 category·κ·preregistration·paired completeness·결측 ITT를 캡처 전에 검증한다. 새 intake compiler는 non-evidence 빈 틀에서 시작해 비식별 CSV의 production floor·ICC·κ·gain·CI를 재계산하고 모두 통과한 경우에만 pack을 쓴다. 생성된 README가 key/split·status-score·taxonomy·실행 순서를 설명하며 관련 계약은 103/103·runtime sampler 4/4다.

외부 종료 GATE

30초 무마이크 rehearsal은 authenticated public WSS ready/ping/close1000, runtime 7 samples, Windows topology 7 samples를 모두 통과했고 physical_capture=false·UUID/email literal 0이다. 남은 것은 사용자가 선택한 장치와 실행 직전 명시 동의를 받은 물리 마이크 3,120초 양방향 soak, 같은 public host·공통 3,000초 시간창의 worker/Uvicorn queue와 process/TCP high-water, 최소 31명·held-out 50회기·150축·blind evaluator 2인의 실제 독립 human voice-gain pack이다. 작성 도구만 준비됐고 사람 데이터는 아직 없다. pack은 check-g7-human-voice-gain.py를 먼저 통과해야 하며 부적합하면 마이크를 열기 전에 exit 2다. 네 artifact가 scripts/check-g7-external-proof.py exit 0을 만들기 전에는 메인 상태를 DONE으로 바꾸지 않는다.

agentic worker + 운영 환류 + human gate

승인 source의 실제 hash·PII를 engine 호출 전에 검사하고 structured generator 1개, 결과를 공유하지 않는 red-team 2개, variant generator와 variant별 독립 judge 3개 이상을 실행한다. 정답 누수·PII·unknown source claim·open finding·안전/보상 해킹·모델/structured 실패는 store 호출 전에 차단한다. repo-approved source는 기본 비활성 scheduler가 durable lease/retry job으로 관리한다. 실제 claude_cli/claude-opus-4-8 7 calls와 dev PostgreSQL reviewer 2·variant 3·pass rate 1.0을 거쳐 synthetic payload를 pending_human_approval로 저장했다. G6 canonical drift trigger는 metadata-only incident→DAG→job을 원자 enqueue하고, 실제 pending 후보의 관리자 검수는 catalog 0→1·approval 1과 역할 403·멱등/409·민감정보 비노출을 통과했다. 별도 누수 후보는 422·저장 0이다. 상세: ops/outcome-os-g8-agentic-worker-evidence-2026-08-07.md.

clean-head NAS-origin 종료 증거

source HEAD 61a41d1f…6af·tree 87dec55d…3b77·2회 동일 archive 4d15d055…119d4d를 active release에 결속했다. candidate session E2E 112/112와 실제 평문 NAS-origin browser review 112/112(11 specs, desktop/mobile/single-run)가 GREEN이며 API/Web d5021950…e4b1/9796c092…4b36, health ok·db/engine true, auth 401, OpenAPI 126을 확인했다. fresh dump 36ec8748…24db8(1,097,100 bytes, TOC 1,738 / TABLE DATA 129)와 previous 6030a677…c611을 보존했다.

실제 rollback receipt DONE

runtime+release_gate 전용 executor는 승인·idempotency·artifact·Compose/env/resolved-policy SHA와 exact API/Web image를 일회성 manifest에 결속하고 HMAC journal·crash recovery·previous-image 복구를 고정한다. 2026-08-07 격리 NAS에서 별도 loopback control-plane API(127.0.0.1:8018)와 별도 executor(127.0.0.1:18149)로 실제 image rollback 2회를 실행했다. rollback-old는 receipt nas-g8-723eeef2…로 previous 이미지 79ec…4450/c530…2f28를, restore-current는 receipt nas-g8-2738846c…로 current 이미지 52e0…8b2d/6fdb…f215를 활성화했다. release gate·approval 각각 2회 멱등, lifecycle rollback/executed 2건, 승인 authorize_rollback 2건, silent auto-promotion 0, HMAC journal 6-record 체인 검증을 확인했다. 상세: 런북 · 기계 판독 증거.

심층 상세 · 검증 로그

로드맵 단계표, 단계별 상세 작업·검증 명령 표, 이번 세션 내러티브. 기본 접힘 — 필요할 때만 펼쳐서 본다.

전체 개발 로드맵 (기존 5단계 + Outcome OS)MASTERPLAN + OUTCOME & ALLIANCE OS
Phase 0closing

기반 정렬 / 운영 안전장치

인프라, 인증 경계, fail-closed, 공개 배포, 회귀 테스트 안정화.

  • 상태: 대부분 완료, 공개 /turn proof만 남음
  • 검증: build + backend 178 기준선 + Playwright 113 기준선, Node/backend focused 120
  • 운영: prod API 8001, engine 9099, tunnel 1개
Phase 1next

MVP 코어 루프

1 페르소나 상담, 실제 턴 저장, 회기말 피드백, 저항 엔진 검증.

  • DoD: 로그인 → P1 상담 완주 → 피드백 수신
  • 추가: 음성 왕복 1턴 PoC 포함
  • 증거: cost/turn DB 적재 + openness 곡선 대조
Phase 2aplanned

3역할 / OAuth / 페르소나

학습자, 교수자, 관리자 권한 분리와 페르소나 확장.

  • DoD: 타인 session 직접 접근 403
  • 범위: OAuth BFF, RBAC, 교수 검수 루프
  • 주의: visible_to와 인간 권한은 별도 레이어
Phase 2bplanned

음성 캐스케이드

STT → 엔진 → TTS 왕복, WSS/터널 안정성, barge-in 로깅.

  • DoD: 50분 WSS 끊김 실측
  • 범위: local_whisper STT + MeloTTS 기본, Deepgram/OpenAI fallback
  • 리스크: 실시간 레이턴시는 실측 전 완료 표기 금지
Phase 3planned

교육용 파일럿 / 효과성

수련생 파일럿, 사전사후 효과 측정, 재귀학습 데이터셋 산출.

  • DoD: 20명 완주 + KPI 충족
  • 측정: SUS, 자기효능감, κ/ICC, 환각률
  • 정정: IRB 게이트가 아니라 데이터 활용동의/개인정보 게이트
Outcome OSG7 external

성과·동맹·수련 폐루프

측정 → 이상 탐지 → 원인 가설 → 재연습 → 전이 검증 → 숙련도 갱신.

  • 상태: G0~G6 internal DONE · G8 clean-head NAS-origin DONE · G7 외부 voice/resource/human 대기
  • 완료 DAG: AOS-001~012
  • 운영: NAS archive 4d15d055…119d4d · candidate/NAS-origin 112/112 · G7 canonical four-artifact checker exit 0 필요
정정 기준: MASTERPLAN 원본의 IRB 신청/승인 게이트는 MASTERPLAN_REVISIONS 기준으로 제거한다. Phase 2는 2a(3역할/OAuth/페르소나)와 2b(음성 캐스케이드)로 분리하고, Phase 1 DoD에는 얇은 음성 왕복 1턴 PoC를 포함한다.
단계별 상세 작업 · 검증 명령 표P0~결정 / 검증 50+행

Phase 0 마감 상세

지금 단계는 구현을 더 벌리는 단계가 아니라, 운영 증거를 닫고 P1 진입 조건을 고정하는 단계다.

상태: 조건부우선순위: P0블로커: public /turn
BLOCK
공개 Google OAuth 실제 /turn proof 확보

로그인 가능한 계정으로 storageState를 저장한 뒤 public-auth-turn E2E를 실행한다.

산출물

apps/web/node_modules/.tmp/public-auth.json, public /turn 성공 로그

검증

E2E_PUBLIC_AUTH=1 + chromium-public-auth 1회 통과

DONE
engine config 운영값 재확인

GET /admin/engine-config로 운영값을 직접 확인했다. engine_mode=claude_cli, engine_url=http://127.0.0.1:9099, model=gateway-default, durable=true, source=database로 의도값과 일치한다.

산출물

config API 응답(durable, db source)

검증

claude_cli / http://127.0.0.1:9099 / gateway-default 의도값 대조 완료

DONE
과거 Live2D demo 자산 제거

Mao/Haru 샘플, Pixi/Cubism 런타임, 공개 /live2d/* 캐시 잔여 접근을 차단했다.

산출물

apps/web/functions/live2d/[[path]].js, SVG 도형 기반 파라미터 리그

검증

운영 /live2d/mao/*, Cubism core 404

DONE
프로세스 난립 정리

운영 확인용 프로세스와 로컬/Tailnet 검증용 dev 프로세스를 의도적으로 분리해 유지한다.

산출물

9099 engine, 8001 prod API, 8000/8010 dev API, 5173 web, cloudflared tunnel 1개

검증

Get-NetTCPConnection에서 대상 포트별 listener 확인

GATE
한신대 공문/데이터 거버넌스 게이트 정리

SSO 클레임, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침을 P1 진입 전 외부 의존성으로 명확히 둔다. 로컬 문서 골격은 준비됐지만 한신대/데이터 steward의 written evidence는 아직 필요하다.

산출물

docs/ops/hanshin-data-governance-gate.md, 공문 질의 항목, 동의 범위 체크리스트, SSO claim mapping 표

검증

문서 artifact 작성 완료; IRB 게이트가 아니라 데이터/SSO 게이트로 외부 증거 필요 상태 유지

DONE
한신대 실사용 피드백 1차 개선팩

오류분석 자료를 컨텍스트 보존, 내담자 출력 품질, 리뷰 privacy/오류문구 UX, 교수자 설명 가능성으로 분해했고 1차 구현을 완료했다. P1은 role mapping + client-only history injection을 원자 패치로 닫았고, P2/P3/P4는 저장형 fallback 없이 빠른 UX 개선으로 배포 가능한 상태다.

산출물

gateway._split_messages(ai_role=client), guardrail.sanitize_client_reply() 품질 게이트, SSE full-response buffer, 리뷰 표시 자연어화, raw error mapper, 교수자 AI 평가 범위 패널, 계획/레드팀/대레드팀 문서

검증

engine_gateway/test_gateway_model.py app/test_orchestrator_masking.py app/test_client_reply_quality.py app/test_session_turn_persistence.py 84 passed, npm run typecheck, npm run check:api-types, session-review.spec.ts focused 8 passed, layout-visual-gate.spec.ts 12 passed, session-layout.spec.ts 8 passed.

팀장 판정: 로컬 회귀와 공개 prod-safe 게이트는 통과했다. 2026-06-29 수동 Cloudflare Pages production 배포가 현재 custom domain asset으로 확인됐고, 운영 반영 전 남은 핵심 증거는 공개 Google OAuth 실제 /turn smoke다. 런타임 mock/demo 자산은 운영 번들에서 제거하고 테스트 fixture만 남긴다.

Phase 0 완료 상세 목록

이전 "완료" 카드 내용을 탭 안에서 항목별로 보존한다.

DONE
DB persona 기반 테스트

session-persistence, teacher, voice/api/personas에서 실제 DB persona를 가져온다.

산출물

seed persona 직접 결합 제거, 실제 persona catalog 기반 E2E

검증

persona 관련 E2E가 DB-backed persona로 통과

DONE
비개발 런타임 보호

prod/staging에서 dev login, seed fallback, OAuth 누락, 기본 secret, localhost CORS를 거부한다.

산출물

fail-closed runtime config validation

검증

backend runtime policy unittest 통과

DONE
compose OAuth 주입

ENVIRONMENT, Google OAuth vars, CORS_ORIGINS, OPENAI_BASE_URL을 API 컨테이너에 명시했다.

산출물

compose 환경 주입 정리

검증

docker compose -f infra\docker-compose.yml --env-file infra\.env.example config --quiet 더미 필수 env 세트로 통과

DONE
admin 모바일 overflow 수정

긴 readiness detail을 안정화했고, 사용자 변경은 DB 저장소가 durable할 때만 허용한다.

산출물

admin responsive layout, durable store gate, AI health copy

검증

admin manage-users desktop/mobile 2 passed

DONE
global engine config 테스트 분리

db-persistence는 전역 engine config를 바꾸므로 @single-run으로 분리했다.

산출물

Playwright single-run tagging

검증

전체 Playwright 113 passed

DONE
handoff와 문서 갱신

docs/HANDOFF.md, docs/dev_dashboard.html, apps/web/e2e/README.md를 최신 상태로 맞췄다.

산출물

handoff, dashboard, E2E README

검증

최신 커밋 기준 상태/검증/운영 포트 일치

DONE
공개 API prod 전환

cloudflared ingress를 127.0.0.1:8001 prod API로 돌렸고 public readiness gate가 통과했다.

산출물

prod API 8001, tunnel config

검증

https://api-vignette.chanpaca.net/health prod/db/engine OK

DONE
공개 런타임 재기동 스크립트

scripts/start-public-runtime.ps1scripts/stop-public-runtime.ps1로 API 8001과 cloudflared를 재현 가능하게 만들었다.

산출물

public runtime start/stop scripts

검증

engine 9099 + API 8001 + cloudflared only

DONE
persona catalog 인증화

/personas는 이제 비로그인 401이다. 로컬과 공개 API 모두 직접 확인했고 E2E 회귀를 추가했다.

산출물

authenticated persona catalog boundary

검증

local/public unauth GET /personas 401

DONE
public API base fallback 보강

public 웹에서 /api/auth/config가 SPA HTML로 떨어지지 않도록 public API origin fallback을 추가했다.

산출물

public API origin fallback

검증

public login screen E2E 1 passed

DONE
학습자 홈 0회 기록 상태

학습자 홈은 fake 기록 없이 실제 서버 세션 0개를 기존 회기 빈 상태와 0 카운트로 표시한다.

산출물

empty history UX, zero count, no fake stats

검증

learner screenshots: document overflow 0, empty history visible

DONE
로컬 5175 로그인 재기동 검증

127.0.0.1:5175 web, 8000 API, 9099 engine을 재기동하고 dev-login 서버 세션과 /learn redirect를 확인했다.

산출물

local dev-login flow proof

검증

desktop/mobile auth flow passed

DONE
active session dense viewport 보정

375px급 active session에서 stage 내부가 1px 넘게 잘리던 문제를 avatar/padding 조정으로 제거했다.

산출물

session layout responsive adjustment

검증

session-layout desktop/mobile 8 passed

DONE
텍스트 턴 SSE 전환

POST /sessions/{id}/stream token 이벤트로만 내담자 자막을 쌓고, HTTP 거절과 SSE error 모두 실패 턴을 transcript와 저장소에 남기지 않는다.

산출물

real SSE stream turn path, failed turn discard

검증

session layout/turn E2E passed

DONE
음성 실패 턴 미저장

음성 회기도 엔진 응답 생성 성공 후에만 learner/client turn을 저장한다. 실패한 transcript는 pending 상태에서 제거한다.

산출물

voice failure persistence guard

검증

voice + voice-success + session-layout 15 passed

DONE
비영구 상태 문구 정리

admin health와 voice degraded reason은 내부 fallback/seed 표현 대신 비영구 런타임 상태를 사용자용 문구로 표시한다.

산출물

operator-facing copy cleanup

검증

settings/admin focused E2E 통과

DONE
직접 URL persona 차단

/learn/session/:code로 직접 들어와도 DB 원본 persona가 아니면 회기 시작을 막는다.

산출물

route guard, degraded/seed fallback regression

검증

unavailable persona code E2E 통과

DONE
demo Live2D 자산 제거

Mao/Haru 샘플과 Pixi/Cubism 런타임을 공개 배포물에서 제거했다. 세션 화면은 SVG 도형 기반 파라미터 리그만 렌더링한다.

산출물

SVG 파라미터 리그, legacy /live2d/* 404 function

검증

Mao/Haru/Cubism core routes 404, no Live2D/Pixi chunks

이번 세션 내러티브 (historical snapshot · 현재 숫자 아님)team lead review

이번 세션은 seed persona 결합 제거, 비개발 fail-closed 설정, compose OAuth 주입, admin 모바일 overflow 수정, persona 인증 경계 보강, 전체 Playwright 재통과, 공개 API prod 전환까지 완료했다. 이번 이어받기에서는 내담자 AI 생성 턴의 provider/model/token/cost 텔레메트리를 /turn, SSE stream, 음성 생성 경로에서 DB app.turns까지 적재하도록 연결했고, gateway stream done/error 계약을 구조화했으며, P1 상담 시작→텍스트 stream→종료→리뷰 피드백 UI E2E와 저항 엔진 정량 회귀 테스트를 추가했다. 이어서 PII 마스킹 게이트 우회 차단, RBAC/IDOR·감사 insert 경로, 음성 paralinguistic 메타 저장, 공개 런타임 watchdog 스크립트와 runbook을 보강했다. 추가로 상주 engine session reuse, SAML provider 스캐폴드, visible_to 런타임 필터, EOT/TTS payload 계약까지 회귀화했다. 백엔드 회귀 테스트는 84개로 재검증했고, 페르소나 승인/반려 API와 교수 콘솔 검수 UI proof를 추가했다. Postgres RLS/audit live smoke checker와 s2s 2차 PoC 판단 메모도 준비했지만, live DB 실행과 s2s 채택 결정은 별도 증거가 필요하다. 이후 로컬 5175 런타임 재기동, admin 사용자 관리 E2E 안정화, 학습자 홈 0회 기록 UX, active session 실제 SSE 스트림 전환, 텍스트/음성 실패 턴 미저장, 직접 URL persona 우회 차단, Live2D demo 자산 제거, AI 운영 fail-closed 보강까지 전체 Playwright로 확인했다. 2026-06-26 15:18 KST 기준 공개 API 터널을 복구한 뒤 전체 Playwright 72개가 desktop/mobile/single-run 모두 통과했다. Cloudflare Pages production 배포 2a58ca49도 완료했고, 커스텀 도메인이 새 asset을 서빙하는 것을 확인했다. 과거 Mao/Haru Live2D demo 자산은 repo와 번들에서 제거했고, /live2d/* 운영 경로는 404로 차단했다. 현재 런타임은 prod API 8001, dev API 8000/8010, web 5173, engine gateway 9099, cloudflared tunnel 1개를 의도적으로 유지한다. 이번 라운드에서는 레이아웃 작업을 서브에이전트 전담으로 분리해 세션, 학습자 홈/리뷰, 관리자/교수자, 설정 화면을 overflow 수리 수준이 아니라 실제 작업 화면 재설계 수준으로 갱신했다. 통합 레이아웃 E2E는 desktop/mobile 54개를 최종 통과했고, 자세한 인수인계는 docs/archive/ops/layout-redesign-handoff-2026-06-26.md에 남겼다. 이번 이어받기에서는 핸드오프가 남긴 "실기기 시각 수용"을 엄격한 자동 게이트로 닫았다. 7개 권장 너비(390/720/861/900/1024/1280/1440)에서 초기 7개 재설계 화면의 가로 overflow 0·컨트롤 클립 0을 강제하는 layout-visual-gate.spec.ts(초기 7 passed/49장, 현재 빈 회기리뷰 포함 9 passed/63장)를 만들고, 화면별 1에이전트 병렬 시각 리뷰 → 6개 병렬 수정 에이전트 → 화면별 적대적 재검수까지 돌려 7/7 accept(critical/major 0, 회귀 0)를 확정했다. 학습자홈 1280 3열 가운데 컬럼 붕괴(critical)와 교수 'API 404' raw 배너를 포함한 결함을 모두 해소했고, 레이아웃 항목을 DONE으로 닫았다. 이번 로그인 복구 라운드에서는 dev/Tailnet OAuth direct start까지 local_oauth_unavailable로 막고, public OAuth state를 HttpOnly 쿠키에 묶인 서명 토큰으로 바꿔 API 재시작 후 콜백이 invalid_state로 실패하지 않게 했으며, callback 실패 reason/status 진단 로그와 화면 메시지 분기를 추가했다. 추가로 Google provider error를 access_denied/provider_error로 분리하고 로그인 화면에 reason code를 노출했다. 이어서 C1 사례개념화 워크시트는 리뷰 API·편집 UI·app.case_worksheet 저장/재조회 경로까지 2차로 연결했다. 공개 Google OAuth 실제 /turn 증명만 storageState 캡처 후 남아 있다.