# @roottale/cms-mcp

## 0.75.4

### Patch Changes

- 965e522: 문의 폼 항목에 `role: "consent"`(동의 기록)를 지정할 수 있습니다. 방문자가 동의할 때 본 안내를 접수 건에 남기는 항목으로, 연락처·문의 요약으로 읽지 않으며 받은 문의에서는 추가 입력 항목 대신 개인정보 동의에 표시됩니다. 지정하지 않은 폼은 기존 동작을 유지합니다.

## 0.75.3

### Patch Changes

- ea4ff28: 콘텐츠 모델의 editor.topic으로 세부 주제 이름·두 단계 선택·최초 발행 필수 여부·안내 문구·카드 표시를 설정할 수 있습니다. 설정이 없는 모델은 기존 동작을 유지합니다.

## 0.75.2

## 0.75.1

### Patch Changes

- 20431b5: 내용이 공개본과 같은 작업본은 계약 재등록 뒤 자동으로 다시 연결하며 대기 중 수정은 보존합니다.
  모델의 선택 숨김 조건과 사이트의 화면 표기 규칙을 공개 확인에 반영합니다.
  표기 규칙이 없는 기존 계약의 checksum은 유지합니다.
- 13e6da1: 필수 칸의 빈 글자와 공백은 값이 없는 것으로 보고 저장·발행을 거절하는 동작을 문서화합니다.

## 0.75.0

### Patch Changes

- 812fe1a: 배경 영상 file 필드(mediaKind: video)의 PC·모바일 MP4와 첫 장면 JPG 공개 값 계약, 직원 전용 업로드·삭제와 고객 선택 절차를 문서화합니다.

  영상 묶음 완료 시 MP4와 첫 장면 JPG의 실제 파일 헤더를 확인합니다.

- a4f12c4: 공개 문의의 vertical 입력값은 검증·동의 판단에 쓰고, CRM 저장 업종과 상태 구성은 사이트 업종 설정을 따르는 계약을 안내합니다.
- d3803b8: 주소 이동 규칙 조회가 대기 시간보다 오래 걸려도 끊지 않고 끝까지 받아 다음 요청부터 적용합니다. Proxy의 `event`를 두 번째 인자로 넘기고, `store`(Vercel은 `getCache()`)를 주면 새 인스턴스의 첫 요청도 규칙을 씁니다. `fetchTimeoutMs`로 조회 제한 시간을 정합니다.
- 710b5b8: 실제화면 편집 계약에 contentAreas 선택 목록을 추가합니다. fields 방식 영역의 문자열을 기존 bodyJson에 저장하며, 연결 주소와 미리보기 예제를 제공합니다.

  화면에 출력하지 않는 영역 입력칸을 hiddenContentAreaFields로 선언할 수 있습니다. 숨긴 칸의 변경은 거부하고 기존 저장값을 보존합니다.

- fed814b: 기존 사이트의 화면 편집 연결 문서에 작업본 반복행 ID 자동 부여와 첫 발행 반영, 계약 등록 단계의 필드 key 검사를 안내합니다.
- 685d215: 실제화면 편집 미리보기가 글 미리보기 방식과 무관하게 사이트 주소에서 열리는 동작을 문서화합니다.
- 7686506: 실제화면 편집 템플릿의 공개 필드에서 이미지·파일·갤러리를 일반 공개 필드와 같은 미디어 객체로 제공하는 동작을 문서화합니다.

## 0.74.0

### Patch Changes

- 7e243cd: 블로그가 아닌 컬렉션(공지·일정 등)의 상세 화면에 `RootTaleBlogPost`를 쓸 때 `categoryHref`를 지정해야 분류 링크가 기본값 `/blog/categories/{slug}`로 나가 404가 되지 않는다는 안내를 블로그 문서에 추가합니다.
- e9b4447: 병원 영업 문의의 상담 예약·실제 방문·노쇼·예약 취소 상태를 외부 동기화 계약과 예제에 추가합니다.
- 3dedb53: tenant-api 공개 CMS GET의 Server-Timing 진단 헤더를 HTTP 문서에 안내합니다. 응답 본문·SDK 호출법은 유지합니다.
- ee30023: 사이트의 등록된 공개 경로 메타데이터를 한 번에 읽는 `fetchSiteRouteMetadata`를 추가합니다.
  기존 단건 조회와 오류·기본값·정책 계약을 유지하고 메타데이터 공통 캐시 태그를 사용합니다.
  외부 Next.js 예제에 렌더 공유 로더와 기본값 대체를 연결했습니다.
  API를 먼저 배포한 뒤 SDK 발행과 사이트 업그레이드를 진행해야 합니다.

## 0.73.0

### Minor Changes

- 5806994: 공개 페이지의 색인을 사이트가 관리하는 `robots.forceIndex` 정책을 추가합니다. 개별 noindex와 분류 승격보다 우선하되 미리보기·미발행·콘텐츠 조건의 `forceNoindex`를 해제하지 않습니다. 관리자와 공개 head·사이트맵이 같은 정책을 사용할 수 있습니다.
- 2c91d43: 병원 공통 비급여를 미리닥 API로 자동 연동하고 ROOT-ADMIN에서 병원 수정·추가·숨김을 관리한다. 기존 셀별 문서와 이력을 보존하며 의료기관 ID를 연결하는 병원 스타터·공개 페이지·인증된 미리보기를 제공한다.

### Patch Changes

- 49a3bfe: 고객 사이트의 well-known 응답에 실제 Next.js·Node.js·React 버전을 연결하는 예제와 ROOT-ADMIN 버전·보안패치 점검 계약을 추가합니다.
- dd539dc: 외부 문의 동기화에 담당자가 답변하지 않기로 결정한 `excluded`(응대 제외) 상태를 추가하고 연동 문서와 Next.js 예제를 갱신합니다.
- dd539dc: 공통 비콘에서 유입 출처와 페이지 이동 경로를 CTA 클릭에 동봉합니다. CTA 이름·위치와 기존 CTA 이벤트를 CRM 방문 여정에 포함하고 첫 페이지 기록 순서를 수정합니다. Next.js 설치·CTA 표식·문의 동봉 예제를 함께 제공합니다.
- dd539dc: CTA 노출·첫 클릭과 문의 오류를 공통 수집합니다. Next 어댑터가 기존 버튼 표식의 노출을
  감지하며 `trackFormError()`로 사용자 정의 검증·접수 실패를 기록할 수 있습니다.
  기본 문의 폼의 HTML 검증 오류와 설치·접수 예제도 같은 계약을 사용합니다.

  비콘 설치 직후 페이지 실행·처리되지 않은 Promise·리소스 오류를 수집합니다.
  처리된 요청 실패는 `trackSiteError()`로 연결하며 원문·스택·요청 URL은 보내지 않습니다.
  Next.js 오류 화면 예제를 추가했습니다.

  관리자의 오류·실패 내역은 사이트 접근 권한이 있는 `@roottale.com` 계정에만 제공합니다.
  고객 계정은 기존 버튼 반응·유입 경로를 이용하며 오류 집계는 서버 응답에서 제외됩니다.

- dd539dc: 외부 원고의 영구 생성 키와 수정·발행 충돌 검사를 관리 API 문서 및 Next.js 연동 예제에 추가합니다. 동기화 체크포인트는 공개 응답에서 제외합니다.
- a9fe1c3: 공개 주소가 없는 공통 콘텐츠의 실제 문구 반영 확인 계약과 Next.js 출력 예제를 추가합니다.

## 0.72.1

### Patch Changes

- ROOT-ADMIN 연동 설정의 GTM 컨테이너 ID를 theme.siteTracking으로 전달하고 안전한 표준 스니펫 헬퍼를 제공합니다.

## 0.72.0

### Minor Changes

- 4341571: 실제화면 콘텐츠 편집의 안정 필드 주소·draft 렌더 영수증·iframe 메시지 검증 계약과
  `@roottale/cms-renderer-next/visual-edit` bridge를 추가합니다. 브라우저 전용 계약은
  `@roottale/cms-core/visual-edit`로 서버용 토큰 코드와 분리합니다. 기존 사이트 템플릿을
  그대로 렌더하고 저장된 draft의 PC·모바일 결과를 확인할 수 있습니다.

  `createRevalidateRoute`에 선택적 `contentEditing`과 `CONTENT_EDITING_CACHE_TAG`를
  추가합니다. 활성화한 사이트는 글 발행·수정·삭제와 분류 변경 시 공통 콘텐츠 태그와
  루트 layout, 기존 경로를 함께 갱신하며 일부 실패도 나머지 갱신 후 HTTP 500으로
  알립니다. 기본 동작은 유지하며 연동 문서·Next.js 예제를 제공합니다.

### Patch Changes

- 33c796b: 관리자 내용 미리보기와 선택적으로 연결하는 사이트 미리보기의 차이, 커스텀 필드·이미지 표시 범위를 문서와 Next.js 예제에 반영합니다.
- aa21fce: 사이트 내용의 동시 편집 충돌 뒤에도 입력값과 저장 버전을 함께 유지한다.
  저장·명시적 복원·되돌리기가 성공한 때만 새 서버 내용을 받아들인다.
  고객 사업장 정보 표시에는 연결 계약의 필드 목록을 전달하고,
  지원하지 않는 예약 입력과 자동 추천 안내를 정리한다.
  필드 기반 자동 제목도 게시 주소를 만들며 AI 응답 전에는 영문 주소와 서버 중복 검사를 사용한다.
- 5caea6c: 가져온 HTML의 줄·빈 문단에 CMS 기본 문단 여백이 중복으로 붙는 문제를 수정한다. 원문에 지정한 CSS·인라인 간격을 유지한다. 편집기·미리보기·공개 본문의 공통 문단 간격은 16px, 큰 소제목 위 간격은 48px, 목록 항목 간격은 8px로 조정한다.
- d38a00f: 사진 중심 편집의 primaryImage 연결, hiddenSections 설정, 글 유형 전용 캘린더 계약과 Next.js 연동 예제를 문서화합니다.
- 4a42501: 사이트 내용의 저장 전 미리보기와 실제 화면 연결 기준을 연동 예제에 보완한다.
- fa50476: 전체 글을 조회하는 fetchAllPosts와 명시적인 페이지 상한·커서 정지 검사 옵션을 추가하고 외부 Next.js 예제의 조회 루프를 교체합니다.
- cb9ae47: 화면 편집의 운영 관리자 origin, 추가 origin 설정과 미리보기 CSP 예제를 보완하고
  DB 선적용 배포 순서를 안내합니다. Next.js 예제는 allowedOrigins를 받을 수 있습니다.
- 4341571: 공개 콘텐츠에 섹션 표시 상태·대표 분류·CTA와 콘텐츠 버전·페이지 계약 key를 전달합니다. 미리보기는 지정한 작업본 버전의 전체 내용을 사용하고, 교체된 작업본은 `preview_superseded` 오류와 새 미리보기 안내로 처리합니다. SDK·렌더러·외부 연동 문서와 Next.js 예제를 함께 갱신합니다.

  실제화면 편집 계약에 등록된 템플릿은 허용된 최상위 필드의 저장 구조를 보존합니다. `visualEditing` 선언 사이트의 일반 필드 포맷에서도 반복 항목의 UUID `_id`를 유지해 순서 변경 후 편집 주소가 달라지지 않습니다. 미선언 사이트에는 새 응답 필드·반복행 ID·계약 기반 경로 계산을 적용하지 않습니다. `cms-fields`의 직접 소비자는 `ResolveContext.preserveRowIds`로 명시적으로 활성화할 수 있습니다.

- a4a6abf: 검색·공유 설정의 관리자 목록에서 검색 설정 계약이 없는 내부 내용 문서를 제외한다.
  실제 페이지·게시물 계약이 있는 문서와 기존 설정의 조회·내보내기는 유지한다.
- a7e66ae: 화면 편집 선언 사이트의 목록·상세·미리보기 응답에서 저장된 편집 상태의 해석 실패를 `content_editor: null`로 전달합니다. 저장값 부재는 필드를 생략하고, 실패 원문과 내부 검수 정보는 공개하지 않습니다. 응답 계약에 null을 허용하고 기존 SDK의 실패 결과 처리 안내를 보완합니다.

  미선언 사이트의 미리보기 translations는 기존 발행 번역 목록을 유지합니다. 작업 중인 slug의 우선 반영은 화면 편집 선언 사이트에만 적용합니다.

- 5c71c7d: 일반 버튼 클릭을 button_click으로 수집하고, 명시적 CTA의 구분 정보를 보존합니다.
  관리자에서 URL별 CTA와 CTA별 클릭 발생 URL을 각각 집계하며, 구분 정보가 없는
  기존 cta_click은 미분류로 표시합니다.
- e97a94f: 공개·미리보기 글에 optional contentEditorResult를 추가해 편집 상태 원본 부재와 해석 실패를 구분합니다. 기존 contentEditor 동작은 유지합니다.

  커버리지 검사에서 계약 컨테이너의 자식 주소와 flexible_content의 행별 layouts를 지원하고, visualEditorOrigins의 HTTP 허용 범위를 브리지와 같은 loopback으로 제한합니다. 연결 문서와 Next.js 예제를 갱신합니다.

## 0.71.0

### Patch Changes

- e55e0ae: 공용 RootTaleImage와 서버·브라우저 공용 delivery 서브패스를 추가합니다. 래퍼 없는 네이티브 img, ref, 정적 import 크기, CF 반응형 직접 전달, 원본 대체, 미리 읽기를 지원하며 사이트별 원본 매핑과 CMS 데이터는 보존합니다. 기존 CfImage와 default export는 유지합니다.

## 0.70.1

### Patch Changes

- 7cef947: FRONT 전용 상세 주소를 쓰는 콘텐츠의 ROOT-ADMIN 사이트 열기 규칙과 Next.js 계약 예시를 추가합니다. 저장 주소·공개 API·리다이렉트는 변경하지 않습니다.

## 0.70.0

### Minor Changes

- 49145e4: 콘텐츠 공개·색인 정책의 기존 단일 when 조건을 유지하면서, 공개 필드가 모두 일치하는 all과 모두 일치할 때만 검사를 제외하는 unlessAll을 추가합니다. 각 그룹은 equality 조건 1~4개만 허용하고 중첩하지 않으며, 기존 공개 필드 참조·검사 개수 한도에 포함합니다.

  명시적인 방송 기록 조건이 모두 충족된 경우에만 검수·출연자 조건의 예외를 적용하고, 출처 필수와 강제 검색 제외를 함께 선언하는 공개 예제를 제공합니다. 누락 값과 null은 false로 바꾸지 않으며 관리자 projection·웹훅·FRONT가 같은 정책을 사용합니다.

  글의 공개 영상 필드를 `videoThumbnail: { source: "youtube", field, when? }`로 연결합니다. 선언한 모델에만 안전한 대표 이미지 다음으로 정확한 YouTube ID의 썸네일을 사용하며, 수동 SEO와 기존 무옵션 모델의 이미지 의미는 유지합니다. 같은 공개 필드와 조건을 관리자 자동값·버전·검증과 FRONT 카드/메타데이터에 재사용할 수 있습니다.

## 0.69.0

### Minor Changes

- 30b830f: 분류 기반 경로에서 선언한 첫 분류 선택, 미분류 대체 경로와 예약 경로를 공통 계산기로 처리합니다. 기존 분류 하나 필수 규칙은 그대로 유지합니다.

  공개 필드와 본문에 기반한 콘텐츠 공개·검색 색인 정책 및 목록 선택 계약을 추가합니다. FRONT의 본문, 목록, sitemap과 관리자 메타데이터가 같은 평가기를 사용하며 강제 검색 제외 사유와 정책 전용 웹훅 캐시 무효화를 제공합니다. 정책을 선언하지 않은 연동의 동작은 유지됩니다.

  글 조회에 캐시 태그 옵션을 공개하고 RootTaleBlogPost에 독립 categoryHref 속성을 추가해 별도 breadcrumb가 있는 사이트도 분류 링크를 정확히 연결할 수 있습니다. 정책 적용 예제와 공개 문서를 함께 제공합니다.

### Patch Changes

- ca5ef33: 공개 분류 API의 주소를 활성 모델 presentation과 같은 분류 계층에서 계산합니다. 레거시 null/blog 분류 범위는 보존하고, 모델이 없는 분류만 기존 컬렉션 설정을 사용합니다. 모델 기반 분류 경로와 완전한 분류 조회를 소비하는 공개 예제를 보완합니다.

## 0.68.0

### Minor Changes

- d7130d8: 기존 고객 사이트의 검색·공유 기본값을 선언형 계약으로 보존합니다. 문자열 커스텀 필드 템플릿, 본문 문단 대체값, Unicode와 단어 경계 말줄임, 고정 이미지 기본값, 모델별 강제 robots와 분류 공개 경로를 지원합니다. 수동 SEO 설정은 우선하며 강제 검색 차단은 유지합니다.

  분류 조회 SDK에 색인 전환 상태와 추가 캐시 태그를 연결하고 외부 연동 문서·실행 예제를 함께 제공합니다.

## 0.67.1

### Patch Changes

- 7eeb714: 공통 메타데이터·주소 이동 편집 조건 문서에 루트테일의 사이트별 기능 허용·제한을 반영하고, 메타데이터 수정 API의 403 코드(`upgrade_required`·`site_denied`·`billing_locked`)를 명시한다.

## 0.67.0

### Minor Changes

- 30d26ac: 공통 메타데이터 해석기·고유 경로 조회·Next SSR 빌더와 캐시 태그를 추가합니다. 기존 canonical과 강제 robots 정책을 보존하고 공유 이미지 대체 텍스트를 OG·X에 동일하게 적용합니다. 분류의 공유 전용 설정과 메타데이터 조회·수정 MCP 도구, Pro 하향 후 공개 적용 유지 계약을 문서와 예제에 반영합니다. 분류 색인 전환을 선언한 사이트가 공개 분류 응답의 `category_index_activated`를 확인한 뒤에만 분류 검색 제외를 적용하도록 안내합니다.

### Patch Changes

- ddaa23f: 고정 페이지에서 검색 제목·설명·공유 이미지를 편집하고 저장값을 복원하도록 연결한다. 공개 사이트의 페이지 SEO 조회와 캐시 갱신 계약을 안내한다.
- 6c8785c: 사이트 코드에 고정 연결된 이미지 블록의 관리자 미리보기·편집 범위 선언과 배포 순서를 안내한다. 배치 규칙을 사용하는 기존 사이트의 동작은 유지한다.
- 94af63e: 문의 폼 설정을 루트테일 관리자 전용 메뉴로 분리하고, 고객은 받은 문의에서 접수 내용을 관리하도록 연동 안내와 예제를 갱신합니다.

## 0.66.0

### Minor Changes

- 7532c0f: 글을 여러 개 담는 활성 `data_only` 모델(`page` 프리셋 제외)은 저장할 때 `presentation.listPaths`가
  1개 이상 있어야 합니다(관리 API `400 bad_request`, `details.reason: "list_paths_required"`).
  이런 모델의 글 변경 웹훅은 더 이상 예전 `/blog` 경로로 떨어지지 않고 `listPaths`만 보냅니다.
  공개 반영 확인은 `listPaths[0]`을 기준 화면으로 보고, 상세 모델이 적은 추가 화면도 확인합니다.
- 716dc9b: 콘텐츠 모델 presentation에 `listPaths`(글을 목록으로 보여 주는 고정 화면)를 추가합니다.
  `data_only`·`detail`·`category_tree`에서 쓸 수 있고, 글 변경 웹훅 `paths`에 함께 실립니다.
  상세 주소가 없는 `data_only` 모델은 이 화면만 갱신하고, ROOT-ADMIN은 그 화면에서 현재
  제목으로 공개 반영을 확인합니다. 공개 콘텐츠 모델 API 응답에도 `listPaths`가 포함됩니다.
- bb7b516: 검색엔진 소유 확인 코드를 공개 테마 응답 `siteVerification`으로 내보냅니다.
  고객이 ROOT-ADMIN 설정 → 연동에서 Google Search Console·네이버 서치어드바이저 코드를
  붙여 넣으면 `theme.updated` 웹훅으로 바로 반영되고, 사이트는
  `siteVerificationMetadata(theme.siteVerification)`를 루트 metadata `verification`에 넣어
  메타태그로 출력합니다.

### Patch Changes

- da23c9e: AVCD 본문 기준으로 기본 읽기 폭을 720px, 행간을 1.7로 맞추고 제목 위계와 문단 간격을 정리합니다. 가져온 HTML 내부 문단에도 24px 간격을 적용하며 모바일 제목 크기를 조정합니다. 기존 테마 변수 재정의는 유지합니다.

  글머리표·번호는 li에 적용되는 CSS reset에서도 유지됩니다. 강조·기울임·인용·코드·이미지·표까지 AVCD의 서식 체계를 적용하며 독립 본문과 가져온 HTML에도 적용합니다. 번호 목록의 시작 번호도 보존합니다. 모바일 제목은 AVCD 실측값인 22/20/18px입니다.

  Pretendard(SIL OFL)를 포함하고 헤더 높이를 고려한 sticky 목차 오프셋과 hover/focus 링크 밑줄을 적용합니다. 제목 내부 고정 크기 마크도 반응형 제목 크기를 따릅니다.

  글 제목은 데스크톱 44px/700/1.3, 모바일 28px/600/1.3으로 통일하고 제목 아래 12px 간격을 적용합니다. 문단에 저장된 고정 글자 크기·행간도 모바일 본문과 소제목 크기를 따르게 합니다. 데스크톱의 문단 서식과 모바일 색상·강조는 유지합니다. 모바일 목차는 닫힌 높이를 52px로 줄입니다.

  본문 이미지를 읽기 폭까지 크게 표시하고 클릭·Enter·Space로 확대할 수 있습니다. 확대 화면은 2배 확대, Esc·닫기, 포커스 복귀를 지원합니다. 독립 본문용 `image-lightbox` 진입점도 제공합니다.

- 1d2be30: 빈 분류 변경도 전체 분류 캐시와 레이아웃을 갱신합니다. 미디어 삭제의 CDN 정리·자동 재시도와 삭제 완료 응답 계약을 문서화합니다.
- 8c6d6c1: 외부 문의 원장의 전체 스냅샷을 사이트별 전용 권한으로 동기화한다. 원본 접수일·유입·상태를 보존하고 중복·알림 재발송을 막으며, 원본에서 삭제된 문의를 사본에서도 제거한다. 관리자에서는 연결된 문의를 읽기 전용으로 제공한다.
- e3ac05b: CMS 관리 API(`/v1/cms/posts…`, 분류 연결·삭제, 관련 콘텐츠)로 쓴 글 변경도 어드민 저장과 같은 발송 대기열을 거친다고 문서에 적었습니다. 웹훅 이벤트·`paths`는 어드민과 같고, 실패하면 자동 재시도하며 발행 알림 기록과 공개 화면 반영 확인에 남습니다. 관리 API의 분류 삭제는 이제 연결된 글마다 `post.updated`를 보내지 않고 `taxonomy.updated`를 한 번 보냅니다.
- 5d52bbf: 글 미리보기 응답(`fetchPostPreview`)이 저장 전 커스텀 필드와 대표 이미지도 편집 중인 값으로 담는다는 점과, 편집기의 '공유 링크 복사'가 없어지고 '사이트 화면 미리보기' 하나만 남았다는 점을 문서에 반영합니다.

## 0.65.1

### Patch Changes

- 1b2d623: 작성자 변경 웹훅이 실제 공개 주소를 갱신하며, 공개 글이 없거나 경로 상한을 넘으면 theme.updated로 전역 갱신하는 계약을 문서와 Next.js 예제에 반영합니다.
- febb0f2: 유입 신호가 없는 방문을 출처 정보 없음으로 표시한다. 브라우저 방문 시작을 익명으로
  첫 확인·재방문으로 분류해 수집하고, ROOT-ADMIN의 방문 유형 통계와 연동한다.
  문서 새로고침·뒤로/앞으로 이동은 새 외부 유입에서 제외한다.
- 0d9ee66: 유입 출처와 첫 도착 페이지를 동봉한 클릭 수집 계약을 추가하고 ROOT-ADMIN에 출처·캠페인별 버튼 클릭 흐름을 표시한다. 기존 클릭은 출처를 추정하지 않으며 외부 유입 집계는 pageview로 유지한다.
- 973032a: 웹훅 실패 원인 확인, 재시도와 수동 복구의 운영 계약을 안내합니다.

## 0.65.0

## 0.64.0

### Minor Changes

- 5ccf503: 한 사이트의 여러 문의 폼을 발행 버전별로 연결할 수 있도록 공통 폼 정의·검증 계약과 `fetchInquiryForm`·`submitFormInquiry` 서버 SDK를 추가합니다. 구조화 답변·동의·중복 재시도·접수증과 같은 사이트의 견적/AS 폼 연동 예제를 제공합니다. 기존 문의 SDK는 유지합니다.

### Patch Changes

- faf7bb5: 관리자 편집 내용을 고객 사이트의 실제 팝업·배너 슬롯에서 미리 볼 수 있도록 출처·창·세션을 검증하는 iframe 연결을 추가합니다. 실제 CSS·배치·닫기 설정을 재사용하며 노출 판정 조회와 숨김 기록 없이 편집합니다. 미리보기 연결과 배포 조건을 문서·Next.js 예제에 설명합니다.
- 5e124de: 미디어 보존 활성화 시 원본 암호화 보관과 검증 이후 업로드를 완료하고, 임시 업로드 경로와 확정 원본을 분리합니다. 완료 재시도는 같은 미디어를 반환하며 삭제 원장은 지연된 완료 요청의 복원을 막습니다. 외부 업로드 연동 문서와 재시도 예제를 갱신합니다.

## 0.63.0

### Patch Changes

- a858d8e: 목차 배치를 사이트 코드의 `RootTaleBlogPost.tocPosition`으로 관리할 수 있습니다.
  명시한 값은 CMS 설정보다 우선하며, 생략한 기존 연동은 CMS 배치를 유지합니다.
  현재 배치를 prop으로 명시하면 실제 화면을 바꾸지 않고 관리 주체를 코드로 옮깁니다.

  공통 블록 디자인은 `RootTaleBlogPost.footerPatternPresentation`과
  `RootTalePostPattern.presentation`으로 전체 대체할 수 있습니다. `null`은 원격
  디자인 주입을 생략하고 사이트 CSS에 맡기며, 생략한 기존 연동은 원격값을 유지합니다.
  고객 콘텐츠와 제작 디자인을 분리하는 문서·발행/미리보기 예제를 함께 갱신합니다.

  공개 `RootTaleCssVars` 타입의 비공개 UI 패키지 참조도 제거해 독립 소비자의
  strict 타입 검사를 지원합니다.

  섹션 구성·디자인 변경 검사 함수를 공개 CMS core에서 공유해 편집기와 저장 단계가
  같은 고객 편집 경계를 적용합니다.

## 0.62.0

### Minor Changes

- 083fc47: 팝업·배너의 예약 시작과 종료를 사이트 재배포 없이 반영하는 공통 runtime과 Next.js 조회 경로를 제공합니다. 공개본과 수정안을 분리하고 일정 변경·일시 중지·예약 취소를 관리 API, MCP, CLI에서 지원합니다. 신규 고객 스타터와 기존 사이트에서 같은 표시 계약을 사용합니다. 메인 홈 전용 자동 캐러셀, 다음 슬라이드까지의 진행률, 모바일 스와이프·스크롤 반응과 쿠키 숨김을 지원합니다.

## 0.61.1

## 0.61.0

### Patch Changes

- 공통 에디터의 글씨 크기·서식 초기화·줄간격·문단 간격·이미지 너비·정렬·사진 설명을
  저장하고 공개 글에 출력합니다. ROOT-ADMIN에서 선택한 내용을 사이트 공통 블록으로
  저장하고 독립 복사본으로 재사용할 수 있습니다.

## 0.60.0

### Minor Changes

- 6074c63: 아직 없는 콘텐츠 예약 — 관련 콘텐츠와 한 세트인 플랫폼 공통 필드. 글이 미래 글을 공개 주소
  키(`유형.분류.슬러그`)로 예약해 두면 대상이 발행되는 순간 공개 `related_posts` 에 자동 합류하고,
  발행 웹훅 `paths` 에 예약한 글의 경로가 함께 실려 참조 페이지가 즉시 갱신된다. 관리
  `PATCH /v1/cms/posts/{post_id}/related` 에 `reserved_keys`(선택) 추가.

### Patch Changes

- a5e53a6: ROOT-ADMIN의 UTC 발행 시각을 사이트 운영 시간대로 표시하는 방법과 UTC 자정 경계 확인값을 블로그 연동 문서에 추가합니다.
- 553623c: Next.js 16 연동 문서와 예시를 `middleware.ts`에서 `proxy.ts` 규약으로 갱신합니다.
- 819f01c: 작성자 사진의 초점 좌표를 작성자 콘텐츠에 두고 공개 글 렌더러가 이를 적용합니다.
  공통 글 하단 블록이 없는 기존 사이트에서는 레거시 CTA를 계속 렌더해 화면을 보존하며,
  사이트맵·이미지 모양 같은 사이트 표현은 프로젝트의 시멘틱 토큰과 코드가 소유합니다.
- 0c460bd: 계층형 콘텐츠 모델의 발행 웹훅이 모델 설정의 실제 허브·상세 주소를 보내도록 고치고,
  수신 사이트가 처리하지 못한 글 갱신을 오류로 드러내는 운영 계약을 문서화합니다.

## 0.59.0

### Minor Changes

- c4099f2: 관련 콘텐츠(공통 필드) — 편집자가 어드민에서 유형 상관없이 고른 발행 글이 글 목록·상세·미리보기
  응답 `related_posts` 로 내려온다(제목·주소·유형·요약·대표이미지·발행일, 고른 순서).
  - cms-client: `CmsPostContent.relatedPosts?: CmsRelatedPost[]` + 와이어 매핑(구 서버는 빈 배열)
  - cms-renderer-next: `RootTaleBlogPost` 가 편집자 선택이 있으면 그것을 그리고(저장 주소로 링크),
    없을 때만 `relatedPostsCount` 자동 추천(같은 카테고리 최신)
  - cms-mcp 문서: 공개 `related_posts` 필드, 관리 `PATCH /v1/cms/posts/{post_id}/related`, blog.md 안내

### Patch Changes

- c0b3679: 공통 블록 배치 규칙의 유형 키를 컬렉션(`collectionKey`)에서 콘텐츠 모델(`modelKey`)로 바꾼다
  (ADR-0109 Amendment 1 · ADR-0105). `SitePatternPlacementRule.modelKey`,
  `findSitePatternPlacementRule`/`setSitePatternPlacementRule`/`resolvePatternSlots` 가 `modelKey` 를
  받는다. 저장된 옛 규칙의 `collectionKey` 필드는 `readSitePatternPlacements` 가 `modelKey` 로 읽는다.
  공개 API 응답 모양(`pattern_slots`)은 그대로이며, 계산 근거가 글의 `model_key` 로 바뀐다 —
  컬렉션 설정이 없는 사이트 글·2단계 분류 모델(FAQ)·모델 key 와 컬렉션 key 가 다른 글도 유형별
  규칙을 받는다. cms-mcp `api-reference.md` 의 `pattern_slots` 설명을 맞춘다.
- a9e3fc1: 발행 웹훅 문서: 알림 주소를 따로 적지 않는다 — 어드민 사이트 정보의 공개 도메인·스테이징 주소에서
  `https://<도메인>/api/revalidate` 가 자동으로 정해지고 운영·스테이징 스위치로 켜고 끈다
  (`revalidation-webhooks.md` §2·문제 해결 표).
- 960677c: 발행 웹훅 문서: 주소가 바뀐 글(slug 변경·카테고리 이동)은 `paths` 에 옛 상세 주소도 함께 온다
  (`revalidation-webhooks.md` §글 웹훅의 paths). 수신 측은 옛 주소 캐시와 옛 주소를 참조하던
  페이지를 같은 요청에서 갱신할 수 있다.

## 0.58.0

### Minor Changes

- 28ef875: 콘텐츠 모델 `editor` 옵션 2개 추가 — `layout: "guided"`(ROOT-ADMIN 편집기를 분류 → 제목 →
  요약 → 본문 → 커스텀 필드 순 한 열로 배치, FAQ용)와 `requiredFields: ["excerpt"]`(요약이 비면
  발행·예약 차단, 초안 저장은 허용). 저장 구조와 공개 API 응답은 바뀌지 않는다. 문서:
  `content-models-and-exposures.md` "코드로 배포하는 모델은 `editor`에서…" 절.
- dd82c92: 공통 블록 표시 형태(presentation) — 블록의 모양(본문처럼/카드·배경색·링크 버튼·버튼 색)을 어드민이
  정해 공개 API `presentation` 으로 내려준다. 사이트는 색·모양을 CSS 에 고정하지 않는다.
  - `@roottale/cms-core`: `readSitePatternPresentation`·`sitePatternPresentationAttributes`·
    `DEFAULT_SITE_PATTERN_PRESENTATION`.
  - `@roottale/cms-client`: `CmsSitePattern.presentation`(구 서버는 기본값), `sitePatternPresentationAttributes`
    (래퍼 data 속성 + `--rt-pattern-bg`·`--rt-pattern-btn-n` CSS 변수).
  - `@roottale/cms-renderer-next`: `RootTaleBlogPost`·`RootTalePostPattern` 이 data 속성·변수를 얹고,
    `cms-public.css` 가 카드/버튼 모양을 그 값으로만 그린다.

## 0.57.0

### Minor Changes

- e222471: 본문 예약 내부 링크(`[[internal:키|문구]]`)를 공용 렌더러가 해석한다.
  - `@roottale/cms-core`: 토큰 정규식·탐색(`findInternalContentLinkTokens`), 경로→키
    (`internalContentKeyFromPath`), 발행 글 경로 색인(`internalContentPathIndex`, 옛 slug 포함),
    텍스트·정화된 HTML 안의 토큰을 링크로 바꾸는 `renderInternalContentLinksInText/InHtml`.
  - `@roottale/cms-renderer-next`: `RenderTiptap`·`RootTaleBlogPost` 에 `internalLinks`
    (Map·함수) 옵션. `RootTaleBlogPost` 는 기본 `"auto"` — 본문에 토큰이 있을 때만
    `fetchInternalContentPathIndex` 로 발행 글 경로 색인을 만들어 링크로 렌더한다.
    대상이 없는 토큰은 문구만 남기고 `data-rt-internal-link-pending="키"` 를 단다.
    `<code>`·`<pre>`·기존 링크 안은 건드리지 않는다.
  - 문서: FRONT 가 토큰을 직접 해석하지 않아도 되는 경로를 안내한다.

- 92d0ad4: 공통 블록(Site Patterns) — 여러 글의 같은 자리(글 하단)에 붙는 재사용 본문.
  - `@roottale/cms-client`: 글 응답 `patternSlots`(자리 key → 블록 key | null, 구 서버는 빈
    객체), `fetchSitePatterns`(발행 블록 목록, `GET /v1/cms/public/patterns`),
    `selectSitePatternForSlot`, `SITE_PATTERNS_CACHE_TAG`(`SETTINGS_CACHE_TAGS` 에 포함 —
    `theme.updated` 로 함께 갱신), `POST_FOOTER_PATTERN_SLOT`.
  - `@roottale/cms-renderer-next`: `RootTaleBlogPost` 가 `patternSlots.post_footer` 블록을 본문
    바로 아래에 자동으로 그린다(목록 요청 실패는 블록만 생략). 자체 글 화면용
    `RootTalePostPattern` 서버 컴포넌트와 `.rt-cms-post-pattern` 스타일 추가.
  - `@roottale/cms-core`: 자리 선언·배치 규칙 정규화·`resolvePatternSlots` (플랫폼 서버·어드민과
    공유하는 순수 규칙).
  - 문서: `theme-and-settings.md` "공통 블록", `api-reference.md` `GET /patterns`·`pattern_slots`.

## 0.56.0

### Patch Changes

- 18aaa9e: ADR-0105 Amendment 1 — 공개 글 응답에 저장된 정규 공개 경로 `path`(cms-client
  `post.path`)를 additive 로 더합니다. FRONT 는 주소를 계산하지 않고 이 값을 링크·사이트맵·
  내부 링크 키에 그대로 씁니다.
- 422c388: ADR-0105 Amendment 1 — FRONT 가 글 주소를 다시 계산하지 않습니다. `RootTaleBlogList`·
  `RootTaleBlogPost`(연관 글·빵부스러기)의 기본 글 링크와 `buildPostMetadata` 의 canonical 이
  플랫폼이 저장한 정규 공개 경로 `post.path` 를 먼저 읽고, 없을 때만 종전처럼 `collections`
  규칙 → `/blog/{slug}` 로 폴백합니다. `storedPostPath(post)` 헬퍼를 `routes` 에서 내보냅니다.
  문서(seo·collections·blog)와 Next.js 예제가 같은 규칙으로 갱신됐습니다.
- d303835: 공개 블로그 설정 응답 `site_profile` 에 메인 홈 전용 검색 제목·설명
  `home_title`·`home_description` 을 additive 로 더합니다(어드민 "검색·공유 표시 >
  메인 홈 검색 노출"). `@roottale/cms-client` 는 `siteProfile.homeTitle` /
  `homeDescription` 으로 노출하며, null 이면 사이트 이름·사이트 설명으로 폴백하는
  것이 계약입니다. cms-mcp 문서 `seo.md` 에 홈 `generateMetadata` 예시를 더했습니다.
- b13696c: ADR-0105 Amendment 1 — `GET /v1/cms/public/redirects` 가 글 공개 경로 이력(post_path_history)
  에서 옛 경로 → 현재 경로 301 을 자동으로 더합니다(`id` 접두사 `path-history:`). 운영자
  규칙이 같은 출발 경로면 운영자 규칙이 이깁니다.
- 86c5712: RootTale 표준 블로그 주소 `/blog/{category}/{slug}` 지원 — `RootTaleSiteConfig.categoryPath`
  (`"direct"` 면 사이트맵 카테고리 허브가 `/blog/{category}`), collection 모드 사이트맵이 각 컬렉션의
  `categoryPath` 를 따르며, `makeCategoryHref(basePath, categoryPath)` 를 `server`·`routes` 에서
  내보냅니다. 문서에 표준 규칙과 라우트 배치를 적었습니다.
- bd450bc: ADR-0105 — 콘텐츠 모델 `detail`·`category_tree` presentation 에 목록·피드 규칙 선택 필드
  (`archives`, `feed`, `categoryPath`, `layout`)를 additive 로 더합니다. 예전 `collections`
  설정에만 있던 규칙을 모델이 소유하며, 공개 `content-models` 응답도 값이 있을 때 함께
  내보냅니다.

## 0.55.0

### Patch Changes

- 6cb9dd5: 공개 글 응답에 `previous_slugs`(옛 slug 목록, 최신순)를 additive로 더합니다.
  `@roottale/cms-client`는 `previousSlugs`로 노출합니다. 주소가 바뀐 글을 옛 경로에서
  파생한 본문 예약 내부 링크 키로도 현재 주소에 연결할 수 있습니다.

## 0.54.0

### Minor Changes

- ad805bd: 글 미리보기를 고객 사이트가 자기 글 템플릿으로 그릴 수 있게 합니다 — 관리자
  미리보기와 발행 결과가 다르던 문제의 해법.
  - 공개 API `GET /v1/cms/public/posts/preview?token=`: 관리자 편집기가 발급한
    1시간짜리 토큰으로 초안(미발행 포함)을 발행 글과 같은 형식으로 돌려줍니다.
    없는 토큰 404, 만료 410 `preview_expired`, 응답 `cache-control: no-store`.
  - `@roottale/cms-client/server`: `fetchPostPreview({ apiKey, token })`,
    `isPreviewExpiredError`, `CmsPostPreviewContent`.
  - `@roottale/cms-renderer-next`: `RootTaleBlogPost`에 `previewToken`·
    `previewExpiredElement`(같은 템플릿으로 미리보기), `RootTalePreviewNotice`,
    `buildPreviewMetadata`(항상 noindex/nofollow).
  - 문서 `blog.md` "미리보기 페이지"·`api-reference.md`, 예시
    `examples/nextjs/app/preview/post/[id]/page.tsx`.

- 4f37084: 페이지·글·정보 모델, 필드 그룹, 노출 슬롯과 캠페인을 API·MCP·CLI에서 모두 관리할 수 있도록 공개 자동화 계약과 문서를 확장합니다.

### Patch Changes

- befa5bb: 콘텐츠 유형별 카테고리 주소와 카테고리 SEO 공개 필드에 더해, 1~3단계 부모·자식
  분류로 목록·허브·상세 주소를 구성하는 범용 콘텐츠 모델 계약을 추가합니다.
- 52306f4: 미래 콘텐츠를 안정 키로 예약하는 `internal_content_keys` textarea 형식을 추가합니다.
  ROOT-ADMIN 전용 입력기와 콘텐츠 저장 API가 키 형식, 접두사, 중복, 최대 개수를 같은
  규칙으로 검증합니다.
- 0b9d28f: CMS 관리 API에 사이트 공통 작성자 선택과 분리된 소유자·공개 작성자 필드를 추가하고, 공개 글·작가 아카이브와 클라이언트가 공통 작성자 원장을 사용하도록 전환합니다.
- 071374d: 본문 예약 내부 링크 표기(`[[internal:{키}|문구]]`)의 키를 "공개 경로 조각을 점으로 이은
  값"으로 정의하고, ROOT-ADMIN 편집기가 콘텐츠 유형·분류·글을 골라 표기를 넣는 도구를
  안내합니다. 에디터 도구 모음에 링크 버튼 뒤 앱 전용 삽입 슬롯(`linkExtras`)이 생겼습니다.
- cc872e6: 콘텐츠 모델이 ROOT-ADMIN의 기본 필드와 계층형 분류 단계 이름을 지정할 수 있게
  하고, 관계형 커스텀 필드를 같은 콘텐츠 모델의 항목으로 제한할 수 있게 합니다.
  관리자 폼의 포커스 테두리가 기본 surface에서 비텍스트 대비 기준을 충족하도록
  공통 focus ring 토큰을 보정합니다.
- 2a7c695: 카테고리 대표 이미지와 검색 문구를 공개 API에서 읽어 카테고리 모음 페이지의
  검색·공유 메타데이터에 사용할 수 있게 합니다.

## 0.53.1

### Patch Changes

- 6df15b6: 고객 사이트의 서버에서 발행 글과 페이지를 함께 검색할 수 있도록 `searchPosts`에 `type: "all"`과 언어 필터를 추가합니다. 검색 결과에는 콘텐츠 유형과 언어를 포함하고, `resolveSearchHitPath`가 블로그·고정 페이지·콘텐츠 유형·다국어 주소를 안전하게 계산합니다. Next.js 통합 검색 예시와 공개 API 문서도 함께 제공합니다.
- 1efecbb: 페이지·글·정보의 콘텐츠 모델 공개 계약과 `modelKey` 조회를 추가합니다. 개발자가 선언한 슬롯에서만 배너·팝업을 조회하고 접근성 있게 렌더하는 API, client, renderer, 예제 문서를 함께 제공합니다. 기존 collections와 collectionKey 계약은 유지합니다.
- a490db2: 사이트 통합 검색의 서버 전용 연동 구조, 실제 콘텐츠 주소 계산, 캐시·장애 처리, 배포 순서와 현재 제약을 설명하는 전용 문서를 추가합니다.
- 866f4ff: ROOT-ADMIN 필드 그룹을 `collection_key` 기준으로 콘텐츠 유형에 연결하는 방법과 공개 `fields` 연동법을 문서화합니다. 의료 vertical의 `doctors` 유형은 의료진 프로필·반복 이력·진료 시간표·관계 필드를 같은 계약으로 제공합니다.
- 5cd0e3b: 주소 이동 middleware가 API 장애 시 stale 규칙을 계속 사용하고, 순환 규칙은 브라우저를 왕복시키지 않도록 통과처리합니다. Site Materializer 납품물에 middleware와 회귀 검증 파일을 필수로 포함합니다.

## 0.53.0

### Patch Changes

- c4dd18d: API 키 발급 권한에 **설정 쓰기(`read_write_settings`)** 가 생겼다 — 어드민 화면 대신 외부 도구가 사업장 정보·상단 메뉴를 고칠 수 있게 하는 권한이다(ADR-0096 B3).
  - `getting-started.md` — 권한 선택지에 `read_write_settings` 추가 + 권한별 scope 표. 지금까지 문서에는 scope 이름이 흩어져 있어서, 어떤 키가 무엇을 할 수 있는지 한눈에 볼 곳이 없었다.
  - 어드민 화면은 scope 이름 대신 사람 말로 된 권한 이름("읽기" · "읽기 + 쓰기" · "읽기 + 쓰기 + 설정 변경")을 쓰고, 발급된 키 목록에도 그 이름과 실제 scope 전체가 붙는다. 문서의 권한 목록에 화면 이름을 함께 적어 두 곳을 이어 놓았다.
  - **권한을 실제보다 좁게 안내하던 두 곳을 바로잡았다.** ① `read` 를 "읽기 전용"이라고 했지만 `cms:read` 하나로 **상담 게시판 글이 생성된다**(`POST /v1/cms/public/inquiries`) — 최소 권한이라고 믿고 발급한 키로 데이터가 만들어지고 있었다. ② `read_write` 설명이 작성·발행만 말하고 **발행 취소·글 영구 삭제·미디어 삭제·분류 삭제**를 빼놓아, 키 유출 시 피해를 실제보다 작게 안내했다. `getting-started.md` · `api-reference.md` 양쪽을 고쳤다.
  - 키 교체 절차의 4단계에 판정 기준을 넣었다. "최근 사용 시각으로 확인"만으로는 부족하다 — 목록이 날짜만 보여 주면 같은 날 교체했을 때 옛 키가 아직 호출되는지 구분할 수 없다(화면은 시각까지 보여 주도록 함께 고쳤다). 이제 "정상 호출 주기를 한 번 넘길 때까지 관찰"을 기준으로 적는다.
  - **이미 발급된 `read_write` 키는 그대로다.** `settings:write` 는 새로 발급하는 키에만 붙는다 — 남의 서버에 들어가 있는 글쓰기 키가 하루아침에 사업장 정보·메뉴까지 바꿀 수 있게 되는 일은 없다.
  - `getting-started.md` 에 **키 교체 절차** 신설. 발급된 키의 권한은 나중에 바꿀 수 없어서, 권한을 올리려면 새 키로 갈아타야 한다. 순서를 틀리면(옛 키를 먼저 삭제) 그 사이 요청이 `401 invalid_key` 로 실패하므로 "새 키 발급 → 환경변수 교체 → 재배포 → 최근 사용 확인 → 옛 키 삭제" 순서를 못박았다. 키 유출이 의심될 때만 순서를 뒤집는다.

  `settings:write` 를 실제로 요구하는 엔드포인트(사업장 정보·상단 메뉴 쓰기)는 아직 없다. 권한 표면을 먼저 여는 이유는, 엔드포인트가 열리는 날 모든 사이트가 키를 재발급해야 하는 상황을 만들지 않기 위해서다.

- a133f27: 블로그 상세 글의 작성·출력 기준을 하나로 맞췄습니다.
  - 이미지 대체 텍스트를 한 줄, 최대 160자로 정규화하는 공용 계약을 추가했습니다.
  - 상세 글 위에 카테고리를 연결하고, 발행일과 실제로 다른 수정일을 구분해 표시합니다.
  - 본문의 공식 출처 블록을 제목과 목록이 있는 시맨틱 구간으로 렌더합니다.
  - 블로그 전용 SEO 점검에서 목차, 외부 링크가 있는 공식 출처, 내용이 채워진 FAQ를 확인합니다.
  - Next.js 상세 라우트가 글을 먼저 조회한 뒤 `notFound()`를 호출해야 실제 404가 된다는 통합 예제를 보강했습니다.

- 2eb82d3: 블로그 작성자 프로필의 기준을 글에 지정된 사이트 작성자 한 곳으로 통합했습니다.
  - 작성자가 없는 글은 전역 설정으로 작성자 카드가 만들어지지 않습니다.
  - 작성자 이름·사진·소개는 글 응답의 작성자 프로필만 사용합니다.
  - 레거시 전역 작성자 응답 필드는 호환을 위해 남지만 항상 `null`입니다.

- 3e5ac18: **수동 갱신 API로 설정 저장 신호(`theme.updated`)를 보낼 수 있게 됐다** (ADR-0096 Phase C1).

  지금까지 `POST /v1/cms/revalidate` 의 `event` 는 글 이벤트 셋(`post.published`·`post.updated`·`post.deleted`)뿐이었다. 그래서 알림 주소를 나중에 등록해 저장 시점의 신호를 놓쳤거나, 수신 라우트를 고친 뒤 설정 캐시를 한 번 비우고 싶을 때 **손으로 할 수 있는 일이 없었다** — 사이트의 재검증 주기(길면 30분)를 기다리거나 어드민에서 설정을 의미 없이 다시 저장하는 것뿐이었다.
  - `event: "theme.updated"` 를 받는다. 받는 값 넷을 `api-reference.md` 와 `revalidation-webhooks.md` 양쪽에 적었다.
  - **이 값만 한 단계 위 권한을 요구한다.** `read_write_settings`("읽기 + 쓰기 + 설정 변경", scope `settings:write`)로 발급한 키가 필요하고, 글쓰기 키(`read_write`)로 보내면 `403 insufficient_scope` 다. 나머지 세 값은 지금까지 그대로 글쓰기 키로 보낸다 — **기존 호출자의 권한은 조이지 않았다.**
  - 권한을 나눈 이유를 문서에 적었다. `theme.updated` 는 경로 몇 개가 아니라 **설정 캐시 이름표 전체 + 루트 레이아웃(그 아래 모든 페이지)** 을 다시 만들게 한다. 글을 쓰라고 내준 키가 사이트 전체 재생성을 반복해서 돌릴 수 있으면 안 된다.
  - 설정 쓰기 API(`PATCH /v1/cms/settings/*`)로 사업장 정보·상단 메뉴를 바꾸면 이 신호는 **저장과 함께 자동으로** 나간다는 점도 함께 적었다 — 직접 보낼 필요가 없는 경우와 있는 경우를 가려 놓았다.
  - 웹훅 발송 트리거 목록에 설정 쓰기 API 호출을 추가하고, 수동 호출 항목에 어떤 이벤트를 지정할 수 있는지 링크를 달았다.

  `paths` 를 함께 보내면 이름표·레이아웃 무효화 **위에** 그 경로들이 더해진다. 비워 두면 홈(`/`)이 기본으로 들어가는데, 이는 `theme.updated` 분기가 없는 옛 수신 라우트(`@roottale/cms-renderer-next` 0.41.0 미만)를 위한 값이다.

- 91aee06: **사업장 정보와 상단 메뉴를 API로 바꿀 수 있게 됐다.** 지금까지 이 두 설정을 고치는 길은 어드민 화면뿐이어서, 사이트를 새로 붙일 때마다 데이터베이스를 직접 손대는 일이 반복됐다(ADR-0096 Phase B).
  - `PATCH /v1/cms/settings/business-profile` · `PATCH /v1/cms/settings/site-nav` 두 엔드포인트를 `api-reference.md` 에 "설정 쓰기 API" 절로 넣었다. 요청·응답 예시, 저장 규칙(길이·개수 상한, https 전용 주소, `HH:MM` 표기), 오류 코드까지 한 곳에 있다.
  - **메서드는 `PATCH` 지만 "그 설정 블록 전체 교체"다.** 부분 병합이 아니라는 사실을 문서 맨 앞에 못박았다 — 한 칸만 고칠 생각으로 그 칸만 보내면 나머지가 지워진다. 주소·좌표·메뉴 그룹처럼 겹겹이 중첩된 값에 병합 규칙을 만들면 "어디까지 덮어쓰는가"가 매번 헷갈리기 때문에 택한 방식이고, 대신 그 사실을 숨기지 않는다.
  - **대상 사이트를 설정 본문과 섞지 않는다.** `site_id` 는 본문 바깥에 적고, 사이트가 둘 이상인 테넌트가 이를 빠뜨리면 `400` 으로 거부한다. 예전 규칙대로라면 "가장 오래된 사이트"가 조용히 선택돼 **엉뚱한 사이트의 간판 정보와 메뉴가 바뀐다.**
  - 응답은 **저장된 값 그대로**다. 보낸 값과 다를 수 있어서(요일 순서 정렬, 목록 중복 제거, 업종 기본값) 다음에 무엇을 보게 될지는 이 응답이 정답이다. 공개 조회로 확인하려 하지 말라고 적었다 — 거기엔 최대 10초 캐시가 걸려 있다.
  - 저장 뒤 나가는 갱신 알림의 결과를 `revalidate` 로 함께 돌려준다. `configured`·`delivered`·`failed`·`degraded` 네 값으로 **"알림을 등록하지 않은 정상 상태"와 "보내지도 못한 상태"를 구분**한다. 지금까지는 둘 다 빈 결과라 겉보기가 같았다.
  - `theme-and-settings.md` 의 상단 메뉴 절과 `getting-started.md` 의 권한 목록에서 이 문서로 가는 길을 열었다.

  권한은 `read_write_settings` 키에만 있다. 이미 쓰고 있는 글쓰기 키(`read_write`)에는 붙지 않으므로, 남의 서버에 들어가 있는 키가 하루아침에 사업장 정보와 메뉴까지 바꿀 수 있게 되는 일은 없다.

- 3ab5570: RSS 생성기에 선택적인 WebSub `atom:hub` 링크를 추가했다. `createFeedRoute`는
  `webSubHubUrl`을 받아 이를 피드에 전달하며, 값을 주지 않은 기존 사이트의 출력은
  바뀌지 않는다. Site Kit은 Google WebSub hub를 기본 연결하고 IndexNow 소유권 확인용
  `/indexnow-key.txt` 라우트를 제공한다.

## 0.52.0

### Patch Changes

- 01f5534: 연동 문서·예시가 **설정 저장 즉시 반영** 배선을 담게 됐다. 지금까지 예시의 revalidate 라우트는 `revalidatePath` 만 넣었고, 그 예시를 그대로 따른 사이트는 어드민에서 전화·주소·메뉴를 고쳐도 최대 30분 옛 값을 보여 줬다 — 예시를 복사해 쓰는 것이 정상 경로인데 그 예시에 구멍이 있었다.
  - `revalidation-webhooks.md` — 예시에 `revalidateTag` 주입 추가. "설정 저장을 즉시 반영하려면 — 캐시 이름표(`tags`)" 절 신설(조회 함수 ↔ 이름표 상수 표, 빠뜨렸을 때의 증상, 자기 진단법). 이벤트 목록에 `theme.updated` 추가 + 저수준(`verifyRootTaleWebhook`) 예시에도 그 분기를 넣었다. 트러블슈팅에 "글은 즉시인데 설정만 늦음" 행 추가.
  - **두 가지 함정을 문서·예시 전체에서 바로잡았다.** ① 이름표를 지울 때는 `revalidateTag(tag, { expire: 0 })` 여야 한다 — `"max"` 같은 프로파일은 `expire` 가 0 이 아니어서 Next 가 stale-while-revalidate 로 취급하고, 다음 요청이 여전히 옛 값을 받는다(`"max"` 의 `expire` 는 1년). `updateTag` 는 즉시지만 서버 액션 전용이라 웹훅 라우트에서 오류가 난다. ② `revalidate` 를 콜백으로 감쌀 때 2번째 인자(`type`)를 그대로 넘겨야 한다 — 안 넘기면 레이아웃 전역 무효화가 페이지 1개 무효화로 줄어 정적 페이지가 안 바뀐다.
  - `theme-and-settings.md` — 맨 앞에 이름표 표를 두고, `fetchTheme`·`fetchBusinessProfile`·`fetchBlogSettings` 예시에 `tags` 를 넣었다.
  - `menus.md` · `collections.md` — `fetchMenu`·`fetchCollections` 예시에 이름표, collections 의 revalidate 예시에 `revalidateTag` 주입.
  - `overview.md` · `getting-started.md` — 사업장 정보·메뉴·콘텐츠 유형 조회 함수를 표에 넣고, "다음 단계"에서 설정 반영 문서를 가리킨다.
  - `examples/nextjs` — revalidate 라우트에 `revalidateTag`, layout 의 사업장 정보 조회에 `BUSINESS_CACHE_TAG`, 헤더 메뉴에 `MENUS_CACHE_TAG`, 블로그 설정 조회에 `BLOG_SETTINGS_CACHE_TAG`.

  이름표 상수와 수신측 동작은 `@roottale/cms-client` · `@roottale/cms-renderer-next` 쪽 변경 사항을 참고.

- f3aef69: 공개 API `/v1/cms/public/theme` 의 `siteNav` 상한이 **좁아진다** — 그룹당 열이 4 → 3, 열당 링크가 8 → 6. 그룹 7개·유틸리티 링크 4개는 그대로다.

  지금까지 `siteNav` 를 저장하는 유일한 경로가 어드민 **설정 > 사이트 > 상단 메뉴** 폼이었고 그 폼은 이미 3열·6링크까지만 입력칸을 제공했다. 그래서 상한을 넘는 값은 만들어질 수 없었고(프로덕션 실측: `siteNav` 를 가진 사이트 0곳), 이번 변경으로 잘려 나가는 데이터는 없다. 저장 스키마·어드민 폼·공개 계약이 각자 다른 숫자를 들고 있던 것을 하나로 맞추는 정리다.

  `@roottale/cms-client` 의 `SiteNavSettings` 타입과 `fetchTheme` 시그니처는 그대로다 — 소비 코드 변경은 필요 없다.

  다만 **상한을 넘는 값이 응답에서 어떻게 되는지**를 이번에 문서화했다: 개별 항목을 잘라내는 것이 아니라 `siteNav` 전체가 빠진다(`undefined`). 손으로 DB 를 고쳐 4열짜리 메뉴를 넣어 둔 사이트가 있다면 메뉴가 통째로 사라지므로, 사이트에는 항상 폴백 메뉴를 두는 편이 안전하다. 모양·상한·폴백 안내는 `docs/theme-and-settings.md` 의 "상단 메뉴 — theme.siteNav" 절에 추가했다.

- cfd78e4: 발행 웹훅의 `paths` 가 글이 속한 **콘텐츠 유형의 주소**를 담는다는 점을 문서에
  명시했다. 지금까지는 공지 유형(`/notice`) 글을 고쳐도 어드민이 `/blog` 주소만
  보내서, 정작 바뀐 목록이 갱신되지 않았다. 어드민 쪽 발송 로직을 고치면서 문서도
  사실에 맞췄다 — 유형별 목록·상세 주소, 카테고리 모음은 그 유형에서 켰을 때만,
  유형을 옮긴 글은 이전·이후 주소가 함께 온다는 것, 그리고 주소 없는 유형·목록 전용
  유형은 상세 주소가 빠진다는 것.

  **수신 측 코드 변경은 필요 없다.** `createRevalidateRoute` 는 예전과 똑같이 모든
  서명 이벤트에서 블로그 목록·피드·사이트맵을 함께 갱신하고, `collections` 를 넘긴
  사이트는 각 유형의 목록 주소도 이미 자동으로 갱신하고 있었다. 공개 API·타입·
  시그니처는 그대로라 patch 로 올린다(문서 문구만 바뀐다).

- 66ad45d: 발행 웹훅 문서에 "주소가 리다이렉트되면 실패한다" 와 Cloudflare SSL 모드
  Flexible 함정을 명시했다. 둘 다 화면에는 아무 오류가 안 뜨고 발행 반영만
  조용히 늦어지는 유형이라, 실제로 자사 사이트와 고객사 한 곳이 각각 이 이유로
  웹훅이 죽어 있었다(2026-07-27 실측).

## 0.51.1

## 0.50.0

### Patch Changes

- ebd8fa1: `docs/seo.md` 에 "색인 위생 — 모음 페이지는 기본 '검색 노출 안 함'" 절을 추가하고, 예시 코드 `app/blog/categories/[slug]/page.tsx`·`lib/blog.ts` 를 `decideArchiveIndex`·`buildArchiveMetadata`·`resolveCategoryPromotion` 사용으로 갱신한다. 사이트맵 절에도 "분류·작가 모음 페이지는 기본으로 빠진다" 를 명시했다.

  문서 예시가 **존재하지 않는 옵션**(`fetchPosts({ category })`)을 쓰던 오류를 고쳤다 — 공개 API 에는 분류별 서버 필터가 없어 최근 글을 `ARCHIVE_POST_COUNT_LIMIT` 만큼 받아 분류별로 세는 것이 정답이다. 그대로 따라 하면 TypeScript 는 컴파일 오류, JavaScript 는 옵션이 조용히 무시돼 전체 최근 글 수를 그 분류의 글 수로 오판했다.

  승격 상태를 boolean 이 아니라 3-state(`promoted`/`not-promoted`/`unknown`)로 다루도록 예시와 정책 표를 바꿨다 — 설정 조회 실패를 "안 켬" 으로 바꿔 넘기면 이미 검색에 올라가 있던 주소에 noindex 가 붙는다. 글 수 모집단 한도를 사이트맵과 공유해야 하는 이유와 그 한계도 문서화했다.

  이 문서는 고객 측 AI 에이전트가 읽으므로 렌더러 변경과 같이 재발행해야 드리프트가 없다.

- ef72e0a: 분류별 글 수를 서버가 센다 — 오래된 글에만 달린 분류가 검색에서 사라지지 않게

  분류 모음 페이지의 "글 0건이면 404" 판정과 사이트맵 포함 여부는 분류별 글 수에서
  나옵니다. 지금까지는 최근 200건을 받아 세었기 때문에, 글이 많은 사이트에서 그
  범위 밖에만 글이 있는 분류가 **모음 페이지(404)와 사이트맵 양쪽에서** 함께
  빠졌습니다.
  - 공개 API에 `GET /v1/cms/public/categories` 추가 — 모든 분류와 발행 글 수를
    서버가 SQL로 집계해 내려줍니다. 집계 범위는 글 목록 API와 같은 어휘
    (`exclude_collections` / `collection_key` / `locale`)로 지정합니다.
  - `@roottale/cms-client` 에 `fetchCategoryCounts()` 추가.
  - `fetchBlogArchiveCategories`(cms-renderer-next)가 이 API를 먼저 씁니다. 못 받으면
    (구버전 API·일시 장애) 예전 방식으로 자동 복귀하므로 기존 동작이 깨지지 않고,
    사이트맵과 모음 페이지는 어느 경로에서든 같은 값을 봅니다.

  사이트 코드 변경은 필요 없습니다 — 패키지를 올리면 적용됩니다. 다만 사이트가
  바라보는 API가 아직 이 엔드포인트를 배포하지 않았다면 예전 동작이 그대로
  유지됩니다.

- 1787ac0: `docs/seo.md`의 에셋 도메인 정합 스캔 섹션을 `scanAssetHosts` 하드닝(base/iframe/embed/object/track/audio/input[type=image] 스캔 대상 확장, `<link rel>` 필터링, `imagesrcset`/`image-set()` 지원, HTML 엔티티 디코드 + fail-closed 파싱)에 맞춰 갱신한다. 이 문서는 npm 패키지에 번들되어 고객 측 AI 에이전트가 읽으므로 renderer 변경과 함께 재발행해야 드리프트가 없다.

## 0.49.0

### Minor Changes

- b618458: Rank Math 1.0.274의 MCP 기능을 참고해 Google Search Console 상위 검색어 조회, 글 SEO·가독성 분석, 발행 글 SEO 점수 조회 도구를 추가했습니다.

## 0.48.0

### Patch Changes

- a4c7070: 문서 갱신 — `blog.md`/`seo.md`에 `author_slug` 가산, 저자 링크·브레드크럼
  (avcd 구조), 카테고리 허브 라우트(`/blog/categories/{slug}`) 필수화 안내,
  avcd 확장 메타데이터(RSS alternate·Twitter Card·og article 확장)를 반영.
  예시 코드에 브레드크럼·BlogPosting·카테고리 허브 라우트 사용법 추가.

## 0.46.0

### Minor Changes

- 69f7d52: 콘텐츠 유형(Collection)에 **주소 없는 유형**(`basePath: ""`)을 지원합니다(ADR-0060). 강사·리뷰처럼 페이지 안에서 불러와 쓰는 콘텐츠는 이제 라우트 없이 운영할 수 있습니다 — `resolvePostUrl`/`resolvePostPath`는 이런 유형의 글에 항상 `null`을 반환하고, `validateCollections`는 basePath 형식·중복 검사를 건너뜁니다(여러 개 공존 허용). 외부 사이트는 posts API의 `collectionKey` 필터로 내용만 가져다 페이지 안에서 렌더하면 됩니다(`RootTaleBlogList`를 임베디드로 쓸 때는 자체 `postHref` 제공 권장). 소속 판정(`resolvePostCollection`)은 영향 없음 — key만으로 소속이 성립합니다. 기존 유형(basePath 있는 유형)은 동작 변화가 없습니다.

## 0.45.0

### Patch Changes

- 23aa6ae: 카테고리 소속을 콘텐츠 유형 설정과 분리하고, 공개 collections 응답의 categories를 분류 원장에서 조립합니다. 사이트 내부 경로 검증을 강화하고 taxonomy.updated 집계 웹훅 계약과 연동 예제를 추가합니다.

## 0.44.1

### Patch Changes

- 4b09885: CMS 자동화 문서의 `read` 권한 범위, R2 미디어 키 경로, CLI 하위 명령 도움말을
  실제 동작과 맞게 바로잡았습니다.

## 0.44.0

### Minor Changes

- b160132: 공개 MCP에 CMS 글 작성·수정·발행, 카테고리/태그 연결, 썸네일·본문 이미지
  업로드·관리 도구를 추가했습니다. 같은 자동화를
  `npx @roottale/cms-mcp cli ...` 명령으로도 실행할 수 있습니다.

### Patch Changes

- 353d437: `RootTaleBlogPost`에 `showTitle` 옵션을 추가했습니다. 페이지가 글 제목을 직접
  출력할 때 `showTitle={false}`를 넘기면 CMS의 중복 `<h1>`만 생략하고 나머지
  헤더 정보와 본문은 그대로 렌더합니다.

## 0.42.0

### Patch Changes

- 1cdc365: 어드민 도메인 변경 반영 — 문서·예시의 `mysite.roottale.com` 을 `admin.roottale.com` 으로 갱신 (키 발급·웹훅 등록 메뉴 경로 안내 포함). 기존 주소는 308 redirect 로 계속 동작.

## 0.41.1

### Patch Changes

- 3810879: Add Turnstile-aware inquiry submission fields, rate-limit error handling, and docs for protected lead intake.

## 0.41.0

### Patch Changes

- 22abf18: docs: 폐기된 `@roottale/cms-renderer-astro` 안내 제거 (ADR-0066 v4.2 Astro 표면 삭제 반영) — overview 패키지 표·blog 관련글·collections 라우팅 문단
- 9f246f4: 목차(TOC) 사이드바 배치 opt-in — 넓은 화면에서 본문 오른쪽 sticky 목차.

  블로그 설정 `toc_position`(`"inline"` | `"sidebar"`) 추가. 기본은 기존과 동일한
  `"inline"`(본문 위 접이식). `"sidebar"` 선택 시:
  - 넓은 화면(본문 컬럼 ≥ 60rem)에서 본문 오른쪽에 스크롤을 따라오는 sticky 목차.
  - 좁은 화면은 CSS 컨테이너 쿼리로 자동 인라인(본문 위)로 폴백 — 마크업 동일.
  - 뷰포트가 아닌 **본문 컬럼 폭** 기준(`@container`)이라 임베드 위치·주변
    레이아웃과 무관하게 안전.

  `RootTaleBlogPost`는 배치를 자동 반영하므로 고객 연동 코드 변경은 불필요.
  `RootTaleBlogSettings` / `ResolvedPostDisplay` 에 `tocPosition` 필드 추가
  (cms-client). 어드민 "블로그 설정 → 목차 위치" 에서 선택.

  공개 API `GET /v1/cms/public/blog-settings` 응답에 `toc_position` 필드 추가
  (cms-mcp api-reference 문서 동반 갱신).

## 0.39.0

### Patch Changes

- chore: linked cms-\* 그룹 버전 정렬 — cms-media(0.27.0)·cms-mcp(0.37.0) 이
  부분 릴리스로 그룹(0.38.0)에서 드리프트. 6개 linked 패키지를 한 릴리스에 묶어
  공통 버전으로 재정렬한다.

## 0.37.0

### Minor Changes

- de62ad1: 작가 아카이브 페이지 + 작가 사이트맵 (blanche식 /blog/author/{slug})
  - `fetchAuthors()` 추가 (`GET /v1/cms/public/authors`) — slug가 있고 발행 글이 1건
    이상인 작가 목록(slug·이름·이미지·소개·글 수·최근 수정일). 어드민 **설정 > 팀**에서
    작가 slug를 발급한다(site 내 unique).
  - `RootTaleBlogList` 에 `author` prop, `fetchPosts` 에 `author` 옵션 추가 —
    `GET /v1/cms/public/posts?author={slug}` 로 그 작가의 발행 글만 렌더(작가 아카이브용).
  - `createSitemapIndex` 에 `authors` 하위 사이트맵(`/sitemap/authors.xml`) 추가 — 어드민
    **설정 > 블로그 > 사이트맵**의 "작가 사이트맵"(`authors`) 토글이 켜졌을 때만 인덱스에
    포함. `authorBasePath` 옵션(기본 `/blog/author`)으로 경로 커스터마이즈.
  - starter 에 `app/blog/author/[slug]/page.tsx` 추가 + cms-mcp seo.md 문서 갱신.

- c77238d: 사이트맵 다국어 hreflang (스캐폴딩)
  - `createSitemapIndex` 가 사이트맵 설정의 `locales`(예 `["ko","ja","en"]`)가 있으면
    모든 섹션(static/blog/categories/authors) entry 에 `alternates.languages`(hreflang)
    를 단다. 첫 로케일 = 기본(현 URL) + `x-default`, 나머지는 path-prefix(`/ja/...`).
    어드민 **설정 > 블로그 > 사이트맵** 의 "다국어 로케일"에서 입력.
  - 같은 slug + 언어 접두사 1:1 을 가정하는 스캐폴딩 — 실제 per-locale 페이지 서빙은
    사이트 책임(번역 콘텐츠 모델 도입 시 재방문). 비우면 단일 언어(기본).
  - 어드민 사이트맵 카드에 "작가 사이트맵"(authors) 토글도 노출 — 작가 사이트맵을
    UI 에서 켤 수 있다.

- 36e2dae: 사이트맵 인덱스 분리 + 블로그 이미지 색인 (blanche식)
  - `createSitemapIndex(config, staticRoutes, opts)` 추가 — Next 16 `generateSitemaps`
    로 `/sitemap.xml`(인덱스) + `/sitemap/static.xml`·`/sitemap/blog.xml`·
    `/sitemap/categories.xml` 하위 사이트맵으로 분리. 50k URL/50MB 한도 확장 + 검색엔진
    섹션별 크롤. 소비자는 `export { generateSitemaps }; export default sitemap;`.
  - 블로그 글 entry 에 대표 이미지(`featuredImageUrl`)를 `<image:image>` 로 색인 —
    어드민 **설정 > 블로그 > 사이트맵**의 토글(`blogImages`)로 제어. `RootTaleBlogSettings.sitemap`
    (`/v1/cms/public/blog-settings` 응답)에 사이트맵 정책(`blogImages`/`locales`/`authors`) 추가.
  - `changeFrequency`/`priority` 는 더 이상 emit 하지 않음(Google 무시 — `loc`+`lastmod` +이미지만). 레거시 `createSitemap`(단일 평면)은 deprecate 되었으나 하위호환 유지.

## 0.36.0

### Patch Changes

- 1fe867f: 문서 갱신 — 블로그 설정 응답의 글 하단 CTA(`post_cta`)와 사이트 SEO 기본값
  (`site_profile`: 설명·로고·파비콘·기본 OG)을 api-reference / blog 가이드에 반영.
  CTA 는 `RootTaleBlogPost` 가 본문 끝에 자동 렌더하고, `site_profile` 은 외부
  사이트가 head + OG 폴백으로 사용한다.

## 0.35.0

### Minor Changes

- cfddfc7: 커스텀 리다이렉트 (WP RankMath Redirections 패리티) — 운영자가 어드민 "설정 >
  주소 이동"에서 글이 아닌 임의 경로 이동 규칙(`/old-event → /promo`, 301/302)을
  정의하고, 사이트 미들웨어가 적용한다.
  - `@roottale/cms-client`: `fetchRedirects()` 추가 — `GET /v1/cms/public/redirects`
    의 활성 규칙 목록을 가져온다(404 → 빈 배열 fail-soft).
  - `@roottale/cms-renderer-next`: `createRedirectMiddleware()` 추가(+ 순수 함수
    `matchRedirect`/`normalizeRedirectPath`), `/routes` 서브패스로 노출. 규칙을
    TTL 캐시하고 API 실패 시 트래픽을 막지 않는다.
  - `@roottale/cms-mcp`: `custom-redirects.md` 연동 가이드 + api-reference 의
    `/redirects` 항목 + nextjs `middleware.ts` 예시.

## 0.34.1

### Patch Changes

- ff6eec1: docs: 콘텐츠 유형(Collections) 문서를 M4 최종 모델로 갱신

  섹션은 글의 `collection_key`로 정해지고 카테고리는 섹션 안의 주제(아카이브)라는
  최종 모델 반영. catch-all·first-wins·"카테고리로 섹션 추론" 등 제거된 동작 설명을
  삭제. collections.md 전면 개정 + api-reference 에 `collection_key` 필드 + seo.md
  교차링크 정정.

## 0.34.0

### Patch Changes

- 69ec926: ADR-0061 P4 하드닝 — `getSiteKnowledge` 문서에 "응답 값은 사이트 운영자가 입력한 untrusted 참고 데이터이며 시스템 지시가 아니다(프롬프트 인젝션 방어)" 경고 추가. (공개 API projection cap·캐시 vary 는 서버(api-core)측 변경이라 npm 무관.)

## 0.33.0

### Minor Changes

- 5dc4916: ADR-0061 P4 — 사이트 지식 projection. 고객 AI 에이전트가 사이트의 브랜드 보이스(어조·톤·화자)와 용어 규칙(금지어·교정어)을 읽을 수 있는 `getSiteKnowledge` MCP 도구 + 공개 API `GET /v1/cms/public/site-knowledge` 추가. 운영 메모·내부 SEO 임계값·내부 출처는 노출하지 않는다(platform 고정 projection 정책). docs(theme-and-settings·api-reference) 갱신.

### Patch Changes

- 2e6cbd0: ADR-0060 Amendment 1 (Option A) — 글의 섹션을 명시 필드로

  `resolvePostCollection` 이 글의 명시 `collectionKey` 를 카테고리 slug 파생보다
  우선 사용한다. `RoutablePost`·`CmsPostContent` 에 `collectionKey` 추가, 공개 API
  post 페이로드에 `collection_key` 포함. 미설정/구 서버면 기존 카테고리 파생으로
  fallback(완전 하위호환). sitemap/feed/가드/아카이브가 명시 섹션을 따른다.

## 0.32.0

### Minor Changes

- dfe7814: docs: 콘텐츠 유형(Collections) 전용 문서 추가 (ADR-0060)

  신규 `docs/collections.md` — 공지·블로그 다중 스트림의 URL 구조, 어드민 "콘텐츠 유형"
  설정, 연동 코드(코드 상수 vs `fetchCollections` 동적 로드), 가드·catch-all·slug 301·동적
  OG·동적 basePath·트러블슈팅을 한 곳에 정리. `docs/seo.md` 의 collections 섹션은 이 문서로
  포인터 처리(드리프트 방지). 공개 엔드포인트 `GET /v1/cms/public/collections` 명시.

  MCP `listDocs()` 는 docs/ 자동 발견이라 새 문서가 바로 노출되고, roottale-web 문서 사이트는
  `PREFERRED_ORDER` 에 `collections` 추가로 노출된다.

## 0.25.0

### Minor Changes

- 0dcb931: 비즈니스 프로필 (로컬 SEO) — 어드민 "운영 > 비즈니스 프로필" 에서 저장한
  사업장 정보(이름·업종·주소·좌표·영업시간·네이버플레이스/구글 비즈니스
  프로필 URL)를 외부 사이트가 조회해 LocalBusiness JSON-LD 를 자동 렌더.
  - cms-client: `fetchBusinessProfile()` (미설정/구 서버 404 = null) +
    `localBusinessSchema(profile, { url, image? })` — @type 중복 제거,
    PostalAddress/GeoCoordinates/openingHoursSpecification/sameAs.
  - API: `GET /v1/cms/public/business-profile` (cms:read).
  - cms-mcp docs: seo.md 로컬 SEO 섹션, theme-and-settings.md
    fetchBusinessProfile, api-reference.md 엔드포인트, examples layout 적용.

- c81991a: CLS(Core Web Vitals) 대책: 본문 이미지에 width/height 출력. 에디터가
  삽입 시 원본 치수를 보존하고(CmsImage), 렌더러(Next·Astro)가 `width`/
  `height` 속성으로 출력 — 기존 CSS(max-inline-size:100%; block-size:auto)와
  조합돼 반응형 유지하면서 레이아웃 시프트 제거. WP import 의 width/height 도
  자동 보존. cms-mcp docs 에 robots.txt·브레드크럼·페이지네이션 가이드 추가.
- 4e7f9f8: llms.txt 라우트 팩토리 (AEO/GEO): `createLlmsTxtRoute(config)` 추가 —
  llms.txt 스펙(https://llmstxt.org)의 마크다운 인덱스로 AI 검색·생성엔진
  크롤러에 사이트 구조·발행 글(최대 100개, excerpt 1줄)을 노출. fetch 실패도
  항상 200(fail-soft). `createRevalidateRoute` 기본 `alsoRevalidate` 에
  `/llms.txt` 포함 — 글 변경 시 AI 크롤러 인덱스 자동 갱신. docs/examples 반영.
- 50b6df0: 메뉴(네비게이션) 연동: `fetchMenu({ apiKey, slug })` / `fetchMenus({ apiKey })`
  — 어드민 "디자인 > 메뉴" 트리(`GET /v1/cms/public/menus`)를 헤더/푸터 네비로
  렌더. 깊이 2, 미존재 404 → null/빈 배열 fail-soft. 새 문서 `menus.md` +
  예시 `components/site-nav.tsx`.
- e84a46c: slug 변경 301 (WP permalink 패리티): public API 가 옛 slug 로도 글을 찾아
  현재 slug 로 응답하고(post_slug_history fallback), `cms-renderer-next/routes`
  에 `postRedirectPath(post, requestedSlug, blogBasePath?)` 헬퍼를 추가 —
  페이지에서 `permanentRedirect()` 로 301 처리. docs/examples 에 패턴 반영.
- 6262fe7: 동적 OG 이미지: `createPostOgImage(config, { ImageResponse })` +
  `OG_IMAGE_SIZE`/`OG_IMAGE_CONTENT_TYPE` — `app/blog/[slug]/opengraph-image.tsx`
  에서 글별 1200×630 소셜 카드 생성. 한글은 Noto Sans KR 부분셋 런타임 로딩,
  글/폰트 fetch 실패 시 fail-soft. `next` 직접 의존 없음(ImageResponse 주입).
- 50b6df0: 공개 검색 API: `searchPosts({ apiKey, query, limit?, type? })` — 발행 글
  키워드 검색 (WP `?s=` 패리티, `GET /v1/cms/public/search`). title·excerpt·
  본문 텍스트 부분일치, 본문 미포함 슬림 hit. 구 서버 404 는 빈 배열 fail-soft.

### Patch Changes

- e7e0849: per-post nofollow 제어 문서화 — 어드민 SEO 패널의 noindex 옆에 nofollow
  토글이 추가됨. `metaJson.seo.nofollow` → Next `robots.follow` 매핑 예시 갱신.

## 0.24.0

### Minor Changes

- 299c9b2: 문의 유입 어트리뷰션 (ADR-0048 §2). `submitInquiry` 에 `attribution` 필드 추가 — 비콘이 기억한 first-touch(처음 도착한 페이지·단축링크/QR 토큰·utm·외부 referrer 호스트명)를 문의와 함께 보내면 어드민 CRM 에 유입 경로가 표시된다. 신규: `@roottale/cms-client/attribution` 서브패스의 `readAttribution()`(브라우저 전용), 서버 엔트리의 `parseAttributionJson()`, intake API `attr_*` 폼 필드. cms-mcp docs(inquiries/api-reference) 및 예제(AttributionField) 동반 갱신.

### Patch Changes

- edba5a1: README 에 사람용 문서 경로 추가 — 공식 문서 사이트(roottale.com/docs) + unpkg 원문 열람

## 0.23.0

### Minor Changes

- e927a42: 드라이런 검증에서 발견된 문서 갭 보완 — examples/nextjs 에 app/layout.tsx
  추가(styles import 포함), getting-started 에 tsconfig `@/*` paths alias 안내 추가

> cms-\* linked 그룹과 버전을 함께 올린다. 변경 시 `pnpm changeset` 으로
> 업데이트 로그를 남기면 Version Packages PR 이 본 파일에 자동 반영한다.

## 0.22.0

- 최초 릴리스 — RootTale CMS 연동 MCP 서버 (stdio). cms-\* 라인(renderer-next
  0.22.0)에 버전 정렬.
  - `blog.md`에 고정 페이지 렌더러 `RootTalePage` (renderer-next 0.22.0) 반영
  - 통합 문서 번들 (`docs/`): 개요, 시작하기, 블로그, 발행 웹훅, 상담문의,
    SEO, 테마/설정, HTTP API 레퍼런스
  - Next.js 연동 예시 코드 번들 (`examples/nextjs/`)
  - Tools: `listRootTaleDocs`, `readRootTaleDoc`, `searchRootTaleDocs`,
    `readRootTaleNextjsExampleCode`, `listPublishedPosts`, `getPublishedPost`
