vignette/docs/TODO.md

23 KiB

Vignette 할 일

상태·결정·검증 증거의 SSOT는 dev_dashboard.html이다. 이 문서는 실행할 다음 행동의 인덱스다. 2026-09-07 이전 완료 로그와 세부 이력은 정리 전 TODO 원문에 보존했다. 2026-09-01 배포 당시의 근거는 NAS 배포 증거이며, 현재 live 상태를 주장하지 않는다. 2026-10-25 후속: 공개 터널을 자동 재시작 compose 컨테이너로 전환했고(8fc829fe 복구 스크립트), 글꼴 92분할본 5c5b66d0을 Pages d4a089db에 반영했다. 남은 것은 사이드바 배경 PNG 경량화, NAS web 이미지 갱신, Cloudflare LAX 경로 관찰이다(반영 영수증). 2026-10-25 운영 점검 결함 수정은 Forgejo master SHA 7facf961c5c48355e1c4a2e05e2688811f49b8db의 NAS API만 승격했다. 감독·연구 주기 제출 번호 충돌, 로그인 확인 지연(last_seen_at 60초 간격), openai 단가 누락, 음성 합성 502 기록을 고쳤고 migration은 없다. 반영 영수증을 따른다. 2026-10-24 승인 릴리스는 Forgejo master SHA b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea의 NAS API/web 승격과 Pages production 42eef402를 완료했다. 라우터 7 동기 갱신 복구·딥링크 next 보존·감독 경로 강제가 포함되며 migration은 없다. 배포 영수증을 따른다. 2026-10-20 승인 릴리스는 Forgejo master SHA aeddaa6972cafabec8113745037533893db0ac34 push, Pages production, NAS API/web 승격과 migration 25 적용을 완료했다. 인증된 운영 내부 UI와 retention 실제 apply는 별도 gate다. 배포 영수증을 따른다.

우선 접수 제품 이슈

최신 원본: 개선관리 워크북 개발·기능 이슈와 임상·교육 이슈를 2026-09-09에 읽기 전용으로 재점검했다. 다운로드 원본 SHA-256은 f64bbc859354e8bfdd62bb3393cffd841ca3a0d865983967a149aea7cf569773이며, 14개 항목은 완료 13·검토 1(C-001)이다. REQ-008~011도 원본에서는 완료다. 14개 항목 매핑은 원본 상태와 로컬 재검증을 구분한다. 원본을 수정하지 않는다.

ID 로컬 상태 우선 행동 및 조치 결과 원본 상태 완료 조건 및 검증 증거
REQ-009 원본 완료 · 기존 구현 재검증 수용 스트림 오류의 입력 복원·부분 턴 미저장·재시도/닫기·음성 상태 복원 구현을 route fixture 기반 browser 재검증으로 수용했다. 완료 uc-session-conversation과 calibration-transfer browser 44 passed/0 failed/0 skipped. fixture 기반 local proof이며 이번 재검증은 build·새 public live 검증·새 배포를 수행하지 않았다.
REQ-010 원본 완료 · 추가 수정 로컬 검증 수용 · 추가 수정 미배포 0턴/client-only 회기가 첫 완료·반복·경험 배지 집계에 섞이는 결함을 찾아 기존 완료 집계와 같은 counselor/learner 발화 조건으로 정렬했다. 완료 계약 RED 4건 뒤 GREEN 4건, 지정 API 20건, API 전체 1108 passed/1 skipped/1 warning, browser 44 passed/0 failed/0 skipped. 이번 추가 수정은 build·새 public live 검증·배포를 수행하지 않았다.
REQ-011 원본 완료 · 기존 구현 재검증 수용 OAS G5 자기예측 저장·잠금의 기존 해결 증거를 route fixture 기반 browser 재검증으로 수용했다. 완료 uc-session-conversation과 calibration-transfer browser 44 passed/0 failed/0 skipped. fixture 기반 local proof이며 이번 재검증은 build·새 public live 검증·새 배포를 수행하지 않았다.
SRC-001 역사 replica 수식 보정 완료 · 과거 수식 오류 미재현 과거 replica의 #REF! 및 15행 집계 범위 보정은 보존한다. 최신 원본 재점검에서는 이를 현재 원본 결함으로 주장하지 않는다. 해당 없음 과거 수정본은 outputs/01a04217-f73b-7303-b597-401fa7f5d290/Vignette_개선관리_완료.xlsx에 보존한다.

P0 운영·외부 게이트

ID 다음 행동 완료 조건 / 차단 이유
AVATAR-001 아바타 fail-closed 후보를 보존 경계 안에서 검증한다. 93 objects·52,973 bytes inventory, DB 참조 보존, public fallback·GET/HEAD full decode·digest receipt·실브라우저 확인 뒤에만 승격 판단. 배포는 승인 필요.
REQ-008 NAS 재부팅 자동복구 smoke를 소유자 승인 뒤 실행한다. 실제 재부팅 뒤 서비스 자동복구, health·로그인·데이터·이미지와 배포 SHA를 확인. Windows 개발 task 이력은 대체 증거가 아니다.
BACKUP-001 백업 운영화를 끝낸다. 실패 알림, off-host 암호화 복제, 정기 restore drill과 보존 정책을 운영 증거로 남긴다. 첫 sidecar 성공만으로 닫지 않는다.
G8-EXTERNAL G8 실DB/public 사람 게이트를 실행한다. 승인·보류·반려 사유와 append-only effect를 실제 DB·공개 경로에서 증명. local fixture는 대체 불가.
G7-EXTERNAL 동의 기반 외부 음성 종료 게이트를 준비한다. 장치 선택·명시 동의 후 3,120초 양방향 soak, 3,000초 공통 high-water, 독립 human voice-gain pack, canonical checker exit 0.
ANTHROPIC-001 claude_cli와 Anthropic API live 동일성을 비교한다. 기관 키를 게이트웨이 호스트에 승인 주입한 뒤 응답·계량·오류 표면화 비교. 키 주입 전에는 실행하지 않는다.
ADMIN-OPENROUTER-001 새 사용자 OAuth finish 성공을 관측한다. API/web 복구·실제 PostgreSQL rollback·배포/보존 census·공개 관리자 UI를 수용했다. OpenRouter UI 상태는 미연결이고 health의 Jev live_verified=false는 live 검증이 아니며, 새 OAuth finish 성공 관측 전까지 진행 중이다. 운영 영수증을 따른다.
JEV-001 충분한 한국어 독립 평가와 전체 지연 반복 비교를 마친다. 운영 API, 합성·인증 브라우저 3턴 runtime과 DB 감정 영속화는 수용했지만 품질 승격은 보류한다. API legacy baseline 1191 passed·1 skipped·0 failed, gateway 82 passed는 구현 회귀 증거이며 품질·성능 우위 증거가 아니다. 위 품질 게이트를 닫은 뒤 전체 사용자 흐름 완료 여부를 판단하며, 최신 probe·수용/반려 근거는 Jev 결정문을 따른다.
JEV-002 v2 평가·표현 프로토콜의 실제 대사 영향을 관측한다. migration 24 선적용과 2026-10-20 API·web 운영 배포까지 완료했다. 로컬 claude_cli 생성 엔진 시간 초과로 v2 지시가 실제 대사에 미치는 영향은 미관측이며, 인증 회기에서 속마음 공개·관리자 v2 trace·대사 반영 관찰이 남는다. 보정 관찰(a_understood 문구, a_sore_spot 과다 선택)은 전문가 검토 대상이다. v2 프로토콜
AVATAR-V3 가상 내담자 아바타 v3(표현 엔진·반응 모션·리노컷 리그)를 P1부터 세션에 연결한다. 1단계 엔진·/dev/avatar-lab 수용(check:avatar-presets 통과·E2E 6 passed), 2단계-A P1 리노컷 레이어 수용. 2단계-B-1b 렌더러 기능 계약·B-1c 모티프 수용. 진행: 2단계-B-1d 표정 판독성 개정(입술 결 래스터, 눈썹 중심선 랜드마크, 이마 주름, 작은 크기 선 보정)과 발화층 립싱크(한글 비짐 + 오디오 선분석, 결정문 §5.4 — 구현·검증됨), 발화 동반층 §5.5·하관 띠 변형(턱·코·볼)·원화 픽셀 입술 구현, 2단계-B-1d 수용(소유자 시각 확인 대기). 2단계-B-2 세션 연결 수용·운영 반영(master 613bcb60, 공개 웹 Pages dd96c2d5, 2026-10-01). P2~P7 리노컷 캐스트 리그 수용·세션 활성화(2026-10-01, 결정문 §8.4.1) 뒤 2026-10-20 Pages production 자산에 반영했다. 2026-10-19 data-render-mode는 v3 ready일 때만 linocut-v3, loading/error/no-rig은 svg로 표시하는 로컬 계약을 6건으로 수용했다. 남음: 인증된 운영 세션의 소유자 시각 확인, 흰자 색 원화 실측·공황 창백 오버레이 사각 경계(후속 다듬기), 3단계 API avatar_cue·지문 어휘 가이드, 4단계 7명 외형 SSOT와 임상 gate. 결정문 · 10/19 closeout · 릴리스 영수증
USER-LATENCY (JEV-001) 실제 경로에서 text display·voice onset·완료 준비를 분리 측정한다. 안전 검사를 유지한 최적화 뒤 반복 비교로 사용자 체감 지연을 평가한다. 현재 CUA 관측상한과 소수 audit은 속도 개선 증거가 아니다.
G6-PRODUCER-CONFLICT 기존 submission id와 content hash를 읽기 전용으로 대조한다. SupervisionResearchConflictError의 동일 id 재실행 idempotency 충돌을 해소하고 해당 테스트와 실제 cycle 성공을 확인한다. Jev·세션 경로와 분리된 기존 운영 충돌이며, 이번 배포 회귀로 단정하지 않는다.
VNET-001 vnet.18ka.net 공개 전환의 외부 설정을 마친다. DNS, Cloudflare zone 권한, Google redirect URI가 모두 준비된 뒤 live 검증.
PIPELINE-001 Forgejo 기준 NAS 자동배포 hook을 구성한다. 수동 git-container clone·SHA 검증·NAS build/compose 절차를 보존한 자동화와 rollback/approval 경계를 검증한다.
INGRESS-001 Cloudflare tunnel 제거 지시의 대체 ingress gate를 닫는다. NAS ingress 대체 경로의 보안·가용성·OAuth 경계를 검증한 뒤에만 tunnel retirement를 승인한다.

외부 거버넌스와 파일럿

ID 다음 행동 완료 조건 / 차단 이유
C-001 적격 외부 임상 검수 패킷을 전달하고 응답을 수집한다. 2026-10-19 결정론적 기술 산출물 6건과 focused 10건은 로컬 수용했지만, 사례별 판정·근거·수정 요구·재검토·검토일 30개, 청소년 답변 6개, 승인 10필드와 서명 증거가 hash/version과 일치하고 review_complete=true가 되기 전까지 외부 gate는 열린다. 10/19 closeout
GOV-001 한신대 데이터/SSO 서면 증거를 수집한다. SSO claim map, 추가 축어록·미성년 동의, 개인정보 처리방침에 대한 기관/data steward 서면 증거.
L1-001 저작권·등재 문서의 스택 설명을 정합화한다. FastAPI 유지 사유와 계약 우선 Node 전환 계획을 외부 제출 문서에 반영.
P3-001 20명 파일럿을 시작한다. roster, 법무 승인 동의, 회기 완료 증거.
P3-002 효과성/KPI를 산출한다. 3척도 pre/post, SUS, κ/ICC, 환각률을 kpi_report.json으로 재현.
P3-003 재귀학습 데이터셋 승인과 동의 감사를 끝낸다. consent·PII·IAA·legal 승인 export 및 withdrawal log 종결.

제품·품질 후속

ID 다음 행동 완료 조건 / 차단 이유
VOICE-001 s2s 2차 비교 PoC를 수행한다. 20턴 기준표의 전사·안전·감사·지연 비교 보고서로 채택/폐기 판단.
FASTLOOP-001 외부 fallback을 구현한다. 로컬 우선 분류기, Haiku/Solar fallback, 동의·전송 가드·관측을 테스트한다.
FINETUNE-001 재귀학습 fine-tuning 경로를 준비한다. 동의·데이터셋 gate가 닫힌 뒤 pipeline과 few-shot 자동갱신 범위를 검증한다.
RETENTION-001 health retention 실제 apply를 승인한다. migration 25를 운영에 적용하고 raw 90일·rollup 365일 dry-run을 applied=false, 삭제 0으로 수용했다. 실제 apply와 데이터 삭제는 별도 소유자 승인 뒤 운영 증거로 남긴다. 수동 escalation 정책은 유지한다. 배포 영수증
EVALHOOK-001 fast-loop eval_hook 사용 정책을 확정한다. 주입된 hook의 활성화 조건과 관측 경계를 소유자가 결정한다.
NODE-001 Node gateway 전환 후보의 계약 범위를 정한다. live endpoint conformance, TurnEvaluationPayload adapter, admin mapper의 작업 패킷과 회귀를 확정한다.
MIGRATION-001 idempotent DB migration runner 도입 여부를 결정한다. init SQL과 runner의 역할 경계, 인프라 영향, 소유자 승인을 확정한다.
OPS-001 운영 티켓 자동 분류·처리 후속을 설계한다. 관리자 승인 뒤 이슈/PR/작업 스레드를 생성하는 범위와 audit 경계를 확정한다.
E2E-001 전 기능 E2E 실패 원인 확정·수정 최신 full fixture는 direct spec 1264건(각 project 632)에서 1254 passed·0 failed·10 skipped·0 flaky(779.880s, exit 0)다. 10 skip 중 desktop/mobile 의도 대칭 6건은 그대로이고, returned-practice DB closed-loop G4/G5 desktop/mobile 4건은 전용 disposable engine/DB/API/Web에서 same-learner 실제 SSE·review·G4/G5 0→1→1과 returned desktop/mobile 4 passed·route mock 0으로 별도 수용했다. 기존 dev DB는 재사용하지 않았고 cleanup 잔여도 0이다. 최초 admin KPI·avatar 간헐 원인은 과거 관측으로 남아 있고 이번 전체 통과로 확정하지 않는다. 전체 수집 1334건의 일괄 완료 주장은 하지 않으며, 기본 Jev 설정의 전체 API 재검증·live_verified와 외부/운영 gate가 남아 closeout 표 기준 전체 DONE은 아니다. 2026-10-21 d801a161+라우터 수정본: fixture 1266건 1252 passed·10 skipped·4 failed(교수자 실엔진 4건, 정상 엔진 재기동 뒤 4 passed), 정상 엔진 single-run 70건 61 passed·4 skipped·5 failed였다. 5건 중 persona-db-lifecycle 1건과 voice-success 2건은 테스트용 API가 공유 DB admin_engine_config 행과 .env의 Jev를 상속한 격리 결함이라 락·행 교체·원복과 legacy 고정으로 고쳐 4 passed(파일 전체)다. session-persistence 코칭 이력은 08-18 버튼 추가로 낡은 선택자를 고친 뒤 live coach 근거에 workbook_0615_case_conceptualization이 없어 실패한다(선택자 오류에 가려져 있던 단언, 근거 선택 기대 결정 필요). 음성 비언어 메타데이터 1건은 로컬 OpenAI TTS TTS transport error 환경 실패이며 단언은 완화하지 않고 이벤트 원문만 남긴다. 기본 Jev 설정의 전체 API 재검증은 1267 passed·1 skipped로 닫았다.
DEV-DEPS-001 dev 전용 의존성 취약점을 갱신한다. 2026-10-24 공개 advisory로 npm audit가 high 2건(vite 6.4.3 dev server, knip 내부 zod)을 보고한다. --omit=dev는 0건이고 운영 정적 번들에는 포함되지 않는다. vite·knip 갱신 뒤 typecheck·build·E2E 무회귀로 닫는다.
CUA-128 실제 배포 Computer Use 128 시나리오를 역할·승인 경계 안에서 재개한다. 카탈로그 생성은 완료했으나 실배포 전체 검증은 미완료다. SHA 1306c524에서 H09와 일반 학습자 로그인·교차 역할 차단·P4 추천·R09 잠금·R14 워크시트 보존을 재확인했지만, T18은 learner 브라우저만 있어 기존 RED를 종결하지 않았다. 순수 teacher·OFF 계정, 교수자 쓰기, 모바일과 독립 관찰자 공개 검증이 남아 있다. 실행 보고를 따른다.

임상 콘텐츠 후속

ID 다음 행동 완료 조건
CONTENT-001 태깅 축어록 4종 활용 gate 임상팀 확정본과 source별 활용 범위
CONTENT-002 C1 사례개념화 루브릭 확정 콘텐츠와 AI 추출/채점 calibration
CONTENT-003 CBT 체인·이론부합 루브릭 임상팀 확정본과 검증 기준
CONTENT-004 평가 골든셋 승인된 콘텐츠와 calibration evidence
C-001 위기개입 프로토콜 임상 승인 C-001 외부 검수와 같은 서면 승인 gate

완료 요약

범위 상태 근거
원본 14개 항목 원본 완료 13 · 검토 1 2026-09-09 최신 원본에서 REQ-001~011과 C-002·C-003은 완료, C-001은 검토다. 과거 완료 9·검토 2는 당시 11개 항목 수집본의 역사 기록이다.
NAS A 경로 2026-09-01 당시 완료 NAS vignette-prod 배포, migration 20/21/22, OAuth 실계정 새 사례→턴→리뷰 E2E, 첫 일일 backup sidecar 실행.
NAS 2차 실배포 & Cloudflare Pages 2026-09-08 당시 배포 기록 Forgejo/GitHub master a0311c59/d9bb5b36의 당시 NAS API·Web 컨테이너 교체, 사전 DB 덤프(12MB), Cloudflare Pages 174개 에셋과 당시 health/auth/web 폐루프·TDD 1104 passed 기록을 보존한다. 이는 2026-09-09의 새 live 검증이나 현재 작업트리 배포 상태 주장이 아니다. 배포 파이프라인 참조.
NAS 3차 실배포 2026-09-09 운영 배포 기록 Forgejo 1306c524의 NAS API·engine·web과 Pages preview를 배포했다. 동시 API·engine 기동의 공백 관찰 뒤 같은 버전에서 healthy, public health db/engine true, auth 401, web 200, P4 6턴과 DB 전체 집계 동일을 확인했다. 무중단 증거가 아니며 GitHub 미러 push는 실행하지 않았다.
G0~G6·G8 내부 구현 완료 증거 보존 G7 외부 종료와 G8 실DB/public 사람 게이트는 계속 열린다.
2026-10-19 로컬 closeout DEVUP-DB-RACE · ADMIN-AFFECT-V2-MOBILE 완료 수용 DB readiness 경합은 managed 경로의 TCP pg_isready·strict API health와 재현으로, 관리자 v2 표는 desktop/mobile 20 passed와 320/390/1440 증적으로 수용했다. 당시에는 미배포·미push였고, 2026-10-20 릴리스로 Forgejo push·Pages·NAS API/web 배포를 했다. 외부/운영 인증 gate는 닫지 않는다. closeout 보고서
2026-10-19 B1 layout gate B1-LAYOUT-720-001 로컬 완료 수용 viewport-fixed/ordinary overflow 오탐을 바로잡고 transform/internal clip 반례를 추가했다. CSS 변경 없이 layout gate 15 passed·0 failed·0 skipped·0 flaky(131.7s), fixed clip 회귀 4건과 session-layout 10건을 수용했다. 운영 배포·전체 E2E 완료 주장은 아니다. closeout 보고서
B3·B3-신규 소유자 결정 결정 및 기존 구현 완료 원문은 정리 전 백로그 원문, 남은 후속만 위에 둔다.
과거 Windows Compose 패키징 gate SUPERSEDED 9/1 NAS docker-compose 배포로 현 production 전환 항목에서 제거했다. 새 secret 주입 과제를 만들지 않는다.
CLEANUP-001 source 경로·문서·코드 경계 정리 완료 tmp/, apps/web/tmp/, legacy .bak 4개, attachment·중복 generation 결과를 outputs/local-history/retained-sources-2026-09-07/에 가역 보존했다. 84 regular source와 supplementary 4 files, junction 4개의 대조를 마쳤고 영구 삭제는 0건이다. API 공통 outcome/practice/auth/admin/turn-memory/voice 경계와 web focus trap·동맹 scale/잠긴 점수·승인 제출 제어도 기존 책임을 보존해 정리했다. Knip dead-code·measurement contract·typecheck/build·Ruff, API 전체 1090 passed/1 skipped/1 warning, gateway 전체 71 passed/1 warning을 통과했고 중복은 17 clone/294줄→3 clone/48줄·265 tokens(0.04%)이다. orchestrator retry는 임상 검수 exact-HEAD 원본 고정 경계이며, voice abort·repository query는 서로 다른 lifecycle·도메인 계약으로 유지한다.
RUNTIME-001 현시점 보존 결정 Windows public-runtime/watchdog scripts는 복구 경로로 유지한다. 이 PC의 두 Scheduled Task가 Disabled라는 읽기 전용 사실은 운영 서버 다운을 뜻하지 않으며, 삭제 승인 대기 작업을 새로 만들지 않는다.
REFACTOR-002 완료 SessionEvaluationWrite의 SQL/cache를 repository로, 공통 정규화·마스킹을 persistence values로 분리했다. AST 기존 대조 20+12 차이 0, focused 149, API 전체 1090 passed/1 skipped/1 warning, gateway 71 passed/1 warning, API 타입 체크·Ruff 통과. 기존 선택형 격리 DB test_admin_usage_postgres.py 1 skipped는 VIGNETTE_USAGE_TEST_DATABASE_URL 미설정이며 새 skip은 없다.
REFACTOR-001 완료 sessionViewModel로 표시 모델을 분리하고 voiceCapture의 캡처·status 책임은 유지했다. lifecycle setter bag hook은 결합도를 키워 채택하지 않았다. Space retry→pause, empty-audio fixture, SessionReview.learnerFeedbackEnabled:true 누락을 교정했고 제품 feedback guard는 유지했다. 최종 UI 두 묶음은 97 passed/1 skipped: session-mvp+uc-session-coach-voice 58 passed/0 skipped, alliance+admin 39 passed/1 skipped다. skip은 uc-review-alliance-pulse 320px desktop 중복 제외이며 mobile은 통과했다. disabled AI feedback privacy focused 1 passed(exit 0)도 유지한다.
Outcome & Alliance OS 완료 ID

I-0. G0 Measurement Truth Foundation

완료 증거는 대시보드에 보존한다.

I-1. G1 Alliance Core

완료 증거는 대시보드에 보존한다.

I-2. G2 Longitudinal Outcome Trajectory

완료 증거는 대시보드에 보존한다.

I-3. G3 Rupture & Repair Lab

완료 증거는 대시보드에 보존한다.

I-4. G4 Deliberate Practice Engine

완료 증거는 대시보드에 보존한다.

I-5. G5 Calibration Mirror & Transfer

완료 증거는 대시보드에 보존한다.

I-6. G6 Supervision & Research OS

완료 증거는 대시보드에 보존한다.

I-7. G7 Multimodal Alliance

내부 완료 증거를 보존한다. 외부 종료는 G7-EXTERNAL에서 추적한다.

I-8. G8 Autonomous Content & Continuous Improvement

내부 완료 증거를 보존한다. 실DB/public 사람 게이트는 G8-EXTERNAL에서 추적한다.

AOS-001 provenance inventory · AOS-002 measurement schema · AOS-003 benchmark case schema · AOS-004 legacy adapter · AOS-005 structured schema · AOS-006 session measurement API · AOS-007 self-assessment lock · AOS-008 Alliance Pulse UI · AOS-009 measurement drilldown · AOS-010 drift/calibration job · AOS-011 deploy proof manifest · AOS-012 SSOT/TODO 동기화.

문서 검증

python -X utf8 scripts/check-dev-dashboard-ssot.py --json
git diff --check