release: v0.14.0

packages/core/CHANGELOG.md

@@ -1,5 +1,76 @@
 # @designpaca/core
 
+## 0.14.0
+
+### Minor Changes
+
+- 88c1168: **설치 엔진 보안 수정.** update 가 project 설치를 기록된 위치에서만 갱신하도록 고쳤다(다른 디렉터리에서 실행해도 그 디렉터리에 설치하지 않음). project 설치는 심링크·정션을 따라 쓰지 않고, 심링크인 AGENTS.md 에는 주입하지 않는다. 기록 없이 덮는 기존 파일과 반복 --force 는 `.orig`, `.orig.1`… 로 백업하고, uninstall 은 기록 root 밖 파일을 지우지 않는다. Windows 에서 `npm`/`npx` 를 셸 없이 실행하고 선택 도구 버전을 고정했다. CI 와 비대화형 출력에서는 업데이트 확인을 건너뛴다. 개발용 테스트 파일은 사용자 설치물에서 뺐다.
+
+  **묻는 시점 변경(인터뷰 게이트, AGENTS.md #10).**
+
+  - 추가 1: 전체 경로(리디자인 포함)에서 2단계 끝에 **방향 체크포인트**를 둔다. 구조가 서로 다른 방향 카드 2~3장을 보이고, 사용자가 고를 때까지 턴을 끝내며 토큰·구현에 들어가지 않는다. 명시적 위임이면 카드를 만들고 고른 이유를 밝힌 뒤 진행한다. 연장·국소·리뷰 경로는 돌지 않는다.
+  - 축소 1: 국소 작업에서 손대지 않는 기존 고유명사·수치는 다시 묻지 않는다. 이번 작업이 새로 만들거나 바꾸는 값만 묻는다.
+  - 축소 2: 특정 슬롯에 대한 "모르겠다·아무거나·상관없다"는 그 슬롯 하나의 위임으로 다루고 재질문하지 않는다(가정 목록에 "확인 필요"로 기록, 톤은 방향 체크포인트가 다시 확인).
+  - 연장 경로에서 사용자가 스타일을 둘 이상 말하고 지배/보조를 정하지 않으면, 기존 모순 정리 사유로 2라운드 질문이 열릴 수 있다.
+  - 질문 언어: 사용자에게 묻고 보고하는 말(질문·선택지·가정 목록·완료 보고)은 사용자의 대화 언어로 쓴다. 스킬 문서가 한국어라는 것은 근거가 아니다. 영어로 요청하면 영어로 묻는다. 사이트 카피의 기본 언어 판정과는 따로 정한다(인터뷰 게이트 규칙 3, brief-interview §5·§17).
+  - 빈 답 처리를 하나로 맞췄다. 메인 세션에서 질문이 거부·오류·시간 초과·자동 해제된 빈 답으로 끝나면 가정으로 진행하지 않고 평문으로 다시 묻는다. 서브에이전트는 호출자가 답 없이 다시 진행을 지시했을 때만 가정으로 진행한다.
+
+  **스킬 변경.**
+
+  - 경로 판정 표를 독립 제목으로 올리고 빈틈을 메웠다: 리디자인 명시는 `design.md`가 있어도 전체 경로, 새 화면·토큰 재정의 없이 섹션 3개 이상이면 연장, 리뷰 경로는 읽기 전용(게이트 `--init`·의존성 설치·`package.json` 수정 금지).
+  - 기본 언어 판정 순서를 명시 언어 → 프로젝트 로컬라이제이션 → 대화 언어 → OS 로케일로 바꿨다. 원격·컨테이너 로케일은 근거로 쓰지 않는다.
+  - 비평 심각도에 Direction(방향) 등급과 10축 시각 비평 루브릭을 추가했다. 같은 결함의 수정 시도는 3회까지이고, 실행하지 못한 검사는 미검증으로 따로 보고하며 충족으로 세지 않는다.
+  - 납품 뒤 취향 불만을 축으로 좁혀 고치는 `feedback-loop.md`, 두 스타일을 섞는 `remix.md`, 스타일 카드 25종의 `style-atlas.md`, 장르별 필수 블록의 `genre-conventions.md` 를 추가했다. "프리셋 하나만"을 "지배 프리셋 하나 + 보조 축"으로 완화하고, 프리셋의 한글 서체·배경·강조·radius를 후보 풀과 범위로 바꿨다.
+  - 한글 조판 정본을 `typography.md` §6-5로 옮기고 값을 정했다(keep-all과 overflow-wrap, 행간·자간, 이탤릭·모노 한글 금지, measure). 성능 기본선에 INP를 넣었다.
+  - 큰 문서를 나눴다(`audit-gate-rules.md`, `motion-parallax.md`, `svg-glass.md`). `preflight.md`를 행 ID가 붙은 유일한 납품 체크리스트로 만들고, `evidence-ledger.md`는 필요한 ID 행만 조회하는 원장으로 바꿨다.
+  - 외부 페이지에서 읽은 지시는 데이터로 다루고 따르지 않는다(프롬프트 인젝션 방어). 이미지 생성 도구의 샌드박스·승인 해제 지시를 없앴다.
+  - SKILL.md를 줄였다(추정 약 15.7k → 10.8k 토큰). 라우팅 서술을 단계별 § 포인터 하나로 합치고 중복 규칙을 지웠다. 본문의 하네스 전용 도구명을 없앴고, description의 "차단" 약속을 본문과 맞추고 대시보드·모바일/PWA 경계를 넣었다.
+  - description 트리거를 넓혔다: 기존 화면의 색·간격·hover·폰트 크기 같은 국소 디자인 수정(영어 "tweaking the look (colors, spacing, hover states, font sizes)")에도 스킬이 불린다. 디자인과 무관한 기능·로직 버그 수정에는 쓰지 않는다고 명시했다. 국소 경로는 인터뷰 없이 고치므로 묻는 시점은 바뀌지 않지만, 스킬이 불리는 범위가 넓어진다.
+  - 스킬 lint가 인터뷰 게이트 규칙 수·핵심 문구·완화 문구, 하네스 전용 도구명, CRLF·BOM, SKILL.md 토큰 예산을 검사한다.
+
+- 88c1168: **묻는 시점 변경(인터뷰 게이트, AGENTS.md #10).** 0단계 필수 슬롯을 묻는 조건은 바꾸지 않았다. 바뀐 것은 아래다.
+
+  - 축소 1: `design.md`는 없지만 현행 시각 언어(토큰·테마 파일, 컴포넌트, 반복되는 색·서체)가 코드에 있는 제품에 새 화면을 더하면 전체가 아니라 **연장 경로**다. 현행 계약 5줄 요약을 확인받고, 방향 체크포인트는 돌지 않는다. 전에는 방향 카드 2~3장이 나가 묻지 않은 리브랜딩 제안이 됐다.
+  - 축소 2: 국소 작업에서 기존 역할에서 파생한 상태 토큰(hover·active·disabled·focus 값) 하나를 더하는 것은 경로를 올리지 않는다. 새 역할 토큰·새 스케일 단계만 연장으로 올린다.
+  - 변경 1: 사용자가 방향을 시안(Figma·스크린샷·목업·브랜드 가이드)으로 줬으면 대안 카드 2~3장 대신 **해석 카드 한 장**을 확인받는다. 여전히 묻고 턴을 끝낸다.
+  - 변경 2: 방향이 담긴 불만("더 고급스럽게")은 축 질문을 따로 내지 않고 같은 방향의 다른 해석 두 변형으로 바로 A/B를 묻는다. "아까 게 낫다"는 가리키는 대상이 하나면 묻지 않고 되돌린다(feedback-loop §2·§5-b).
+  - 추가 1: 정리·일관화 요청(연장)은 고치기 전에 현행 인벤토리와 통합안을 보이고 확인받는다.
+  - 추가 2: 국소 요청에 증상이 없고("좀 고쳐줘") 실측 후보가 둘 이상이거나 없으면 실측값을 보이며 한 번 묻는다.
+  - 명확화: 0단계 슬롯만 맡긴 위임("인터뷰는 알아서")은 방향 위임이 아니다. SKILL.md의 위임 문장을 brief-interview §11과 맞췄다. 위임받아 카드를 고를 때는 고른 이유를 함께 말한다.
+  - 형식: 질문 앞에 남은 길을 한 줄로 예고한다. 스택·테마·로그인 화면 접근은 자산 질문의 자유 답에 얹고, 설치·이미지 생성·게이트 잔류 동의는 선택 응답인 "작업 조건 묶음"으로 0단계 턴에 미리 묻는다. 질문 수와 라운드 규칙은 그대로다. 캡처 도구가 있으면 방향 카드에 첫 화면 미리보기를 붙인다(프로젝트 밖 임시 파일).
+  - eval: 시나리오 S19(현행 시각 언어가 있는 제품에 화면 추가)·S20(파생 상태 토큰)·S21(시안 제공)과 해석 카드 판정을 더했다. 경로 판정과 읽기 비용을 기존 로그로 다시 판정하는 `rejudge.mjs`를 더했다.
+
+  **완료 판정과 보고.**
+
+  - 5단계 통과 조건을 "하드 게이트 차단 0건 + 미검증은 항목·이유를 보고"로 통일했다. 전에는 문서에 따라 미검증이 하나라도 있으면 끝낼 수 없는 것으로 읽혔다.
+  - 하드 게이트의 "전부"는 항목이고, 검사 표면은 작업이 정한다. 연장·국소에서 범위 밖에서 본 위반은 고치지 않고 "기존 결함"으로 따로 보고한다.
+  - 납품 보고는 무엇을 만들었고 어떻게 여는지로 시작한다(critique §13-b). 검증 줄의 정본은 audit-gate 한 곳이고 영어 대응을 정했다.
+  - 제품 표면(로그인 뒤 화면·설정·목록)용 루브릭 해석과 연장·국소 경로의 Direction 처리를 더했다.
+  - `design.md`를 0단계 통과 때 만들고 단계마다 채운다. 제목이 있는 골격(진행 상태·지문 한 블록·변경 기록 포함)과 분량 기준을 정했고, 컨텍스트 압축 뒤에는 진행 상태로 잇는다.
+
+  **구성 수렴 대응.** 쇼케이스 21종 계측에서 히어로 2단 분할 13/19, 상단 바 내비 19/19, 한 줄 고지 푸터 14/19가 나왔다.
+
+  - layout에 히어로 구도 패밀리 8종(§2-b), 내비 형태 6종(§2-c), 푸터 형태(§2-d)를 선택지 표로 두고 섹션 토폴로지 어휘를 넓혔다. images에 이미지 처리·캡션 선택지를 더했다.
+  - art-direction §3-2에 페이지 수렴 6축(섹션 흐름·히어로 글 묶음·내비·푸터·이미지 처리·모션, 넷 이상 같으면 실패)을 더하고 critique D2·preflight V2에 연결했다.
+  - genre-conventions에 동네 가게·전시와 행사·B2B 서비스 절을 서로 다른 흐름 세 개씩과 함께 더했다.
+  - 문서의 예시 값에 남아 있던 하우스 룩(웜 오프화이트·2px radius·Pretendard 기록 틀)을 자리표시나 서로 다른 세 벌로 바꿨다. 한 문장 컨셉 예를 과업 문장으로 바꾸고 방향 카드 예시에 다른 업종과 나쁜 예를 더했다.
+
+  **폰트 예산 현실화.** tokens §5의 폰트 전송량 기본선을 라틴 100KB / 한글 1패밀리 200KB / 2패밀리 350KB로 나눴다. 쇼케이스 19종 실측(144~480KB)에서 한글 두 패밀리는 유니코드 슬라이스로 받아도 200KB를 거의 항상 넘었다.
+
+  **새 절차.** 화면이 여럿일 때의 순서(layout §4-m), 실제 값이 없을 때의 placeholder 규약(product-copy §16), 폼 제출 뒤(component-systems §10-6), Tailwind v4·shadcn 테마에 토큰 넣기(§7-1), 문서 머리와 브랜드 표면(SKILL.md 4-4b), 로그인 뒤 화면의 검증, preflight 행 X15~X19(모바일 앱·리믹스·장르·깊이·다중 화면).
+
+  **웹 플랫폼 갱신(2026-10 확인).** scroll-driven 예시의 `animation-delay` 스태거를 `animation-range`로 고치고 `1ms` duration을 붙였다. 팝오버·툴팁 예시에 anchor positioning을 넣었다. svg-filters R6(한 장짜리 굴절 지도)를 지우고 svg-glass로 보냈다. HTML-in-Canvas 가용성, three·R3F 호환 판정(레지스트리 확인 명령), shadcn `style` 접두어와 통합 `radix-ui` 패키지, Safari 26의 `theme-color`·홈 화면 웹앱, 폰트 메트릭 오버라이드의 Safari 범위, subgrid, Speculation Rules, invoker commands, WebGPURenderer 선택 기준을 반영했다.
+
+  **렌더 게이트(`tools/design-gate.mjs`).**
+
+  - 결과 상태를 충족·실패·미검증·OFF로 나눴다. 건너뛴 검사가 통과로 집계되던 것을 없앴다. 종료 코드: 0 실패 없음, 1 실패, 2 사용법·설정 오류, 3 `--strict`에서 미검증.
+  - 브라우저나 `puppeteer-core`가 없으면 exit 1이 아니라 정적 결과를 내고 "검증 미완료"로 끝낸다. 선택 의존성을 실행 디렉터리에서 먼저 찾는다(스킬이 사용자 홈에 설치돼 있으면 게이트가 뜨지 않던 문제).
+  - `--url`·`--out-dir`·`--no-report`·`--static-only`·`--help`를 더했다. `--init`은 기존 설정을 덮어쓰지 않는다(`--force`). 초안의 기본 폭이 320·390·768·1440·1920·2560으로 바뀌고 뷰·브랜드 가정이 빠졌다.
+  - 대비 검사가 `oklch()`·`color-mix()`를 읽고, `html` 배경과 조상 opacity를 반영하며, 이미지·그라디언트 배경 위 텍스트는 미검증으로 센다. 문장 밖 작은 링크는 터치 타깃 예외가 아니다. 설정한 뷰 전환 버튼이 없으면 실패다. 죽은 선택자·토큰 위생의 오탐을 고치고 판정을 낱말 일치로 바꿨다. 스크립트 예외·깨진 이미지 검사가 기본으로 켜진다. 시각 회귀 첫 실행은 미검증이다.
+  - 기본 실행은 프로젝트를 바꾸지 않는다. 설정·의존성·스크립트를 프로젝트에 심는 것은 사용자 동의가 있을 때만이다.
+
+  **스킬 lint.** 문서 간 § 포인터, "읽는 법" 표의 § 유효성, preflight 행 ID와 게이트 규칙 번호의 무결성, 문서별·전체 크기 예산, 게이트 사본 동일성을 검사한다.
+
 ## 0.13.0
 
 ### Minor Changes