@roottale/cms-mcp 0.57.0 → 0.58.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @roottale/cms-mcp
 
+## 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

package/dist/index.js

@@ -1559,7 +1559,7 @@ function registerTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.57.0" : "dev";
+var VERSION = true ? "0.58.0" : "dev";
 var SERVER_INSTRUCTIONS = `
 roottale-cms-mcp\uB294 RootTale CMS\uB97C \uC678\uBD80 \uC0AC\uC774\uD2B8(\uC8FC\uB85C Next.js)\uC5D0 \uC5F0\uB3D9\uD558\uACE0
 \uAE00\xB7\uC378\uB124\uC77C\xB7\uBCF8\uBB38 \uC774\uBBF8\uC9C0\uB97C \uC790\uB3D9\uD654\uD558\uAE30 \uC704\uD55C \uBB38\uC11C\xB7\uC608\uC2DC \uCF54\uB4DC\xB7API tool\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.

package/docs/api-reference.md

@@ -457,10 +457,15 @@ settings.siteProfile.defaultOgImageUrl` 순으로 우선합니다. `logo_url`·
 { "tenant_id": "…", "site_id": "…",
   "patterns": [ { "id": "…", "key": "clinic-guide", "name": "병원 안내",
                   "description": "글 하단 공통 안내", "body_json": { "type": "doc", "content": [ … ] },
+                  "presentation": { "layout": "card", "background": "#f8f9fa",
+                                    "link_style": "buttons", "button_colors": ["#03c75a", "#1a1a1a", "#666666"] },
                   "status": "published", "updated_at": "…" } ] }
 ```
 
 - 자리 key: `post_footer`(글 하단, 본문 바로 아래). 새 자리는 문서와 함께 추가됩니다.
+- `presentation` = 어드민이 정한 표시 형태(`layout` plain|card, `background` hex, `link_style`
+  text|buttons, `button_colors` hex 순서 — 마지막 문단의 링크에 차례로, 모자라면 마지막 색 반복).
+  사이트는 이 값을 래퍼의 data 속성·CSS 변수로 옮겨 그리고, 색·모양을 따로 고정하지 않습니다.
 - 캐시: `Cache-Control: private, max-age=10`. 어드민에서 블록·배치 규칙을 저장하면
   `theme.updated` 웹훅이 오므로 설정류 캐시와 함께 지우세요(`revalidation-webhooks.md`).
 

package/docs/content-models-and-exposures.md

@@ -173,6 +173,26 @@ ROOT-ADMIN은 발행·예약 시 선언한 깊이의 말단 분류인지 다시
 `categoryLevels`의 개수는 `categoryDepth`와 같아야 합니다. 최종 선택에서는 말단
 분류 ID 하나만 기존 카테고리 관계로 저장됩니다.
 
+FAQ처럼 **요약이 본문보다 앞서고 분류가 주소를 정하는 모델**은 `editor.layout`을
+`"guided"`로 두면 ROOT-ADMIN 편집 화면이 작성 순서 한 열로 바뀝니다 — 분류 →
+제목 → 요약 → 본문 → 커스텀 필드. 주소·검색결과·공유 이미지·표시 옵션은 "공개
+설정" 한 곳으로 접히고, 오른쪽 발행 설정에는 작성자·태그만 남습니다. 생략하거나
+`"default"`면 일반 글 배치(제목 → 본문 → 발행 설정 → 검색·공유 설정)입니다.
+`editor.requiredFields`에 `"excerpt"`를 적으면 요약이 비어 있을 때 발행·예약을
+막고(초안 저장은 됩니다) 편집기에 필수 표시(`*`)를 붙입니다. 제목은 항상 필수라
+적지 않습니다. 저장 구조·공개 API 응답은 두 옵션 모두 바꾸지 않습니다.
+
+```json
+{
+  "editor": {
+    "layout": "guided",
+    "requiredFields": ["excerpt"],
+    "labels": { "title": "질문", "excerpt": "요약 답변", "body": "상세 답변" },
+    "categoryLevels": ["영역", "질환"]
+  }
+}
+```
+
 관계형 커스텀 필드는 `postType`과 함께 `modelKey`를 지정하면 선택 대상을 같은
 콘텐츠 모델로 좁힐 수 있습니다. 예를 들어 `relationship` 필드에
 `"postType": "post", "modelKey": "faq"`를 선언하면 관련 FAQ만 표시됩니다.

package/docs/theme-and-settings.md

@@ -177,6 +177,13 @@ import { RootTalePostPattern } from "@roottale/cms-renderer-next/server";
 <RootTalePostPattern apiKey={apiKey} post={post} />
 ```
 
+블록의 **표시 형태**(`presentation`: `layout` 본문처럼/카드, `background` 카드 배경색,
+`linkStyle` 글자/버튼, `buttonColors` 버튼 색 순서)도 어드민이 정해 내려줍니다. 사이트
+CSS 에 색·모양을 고정하지 말고 `sitePatternPresentationAttributes(pattern.presentation)`
+가 주는 data 속성(`data-pattern-layout`, `data-pattern-link-style`)과 CSS 변수
+(`--rt-pattern-bg`, `--rt-pattern-btn-1..n`)를 래퍼에 얹은 뒤 그 값만 읽으세요.
+`RootTaleBlogPost`·`RootTalePostPattern` 은 이미 그렇게 그립니다.
+
 블록 목록은 `rt-site-patterns` 캐시 이름표를 가지며, 어드민에서 블록·배치 규칙을
 저장하면 `theme.updated` 웹훅이 다른 설정과 함께 지웁니다(`createRevalidateRoute`
 에 `revalidateTag` 주입 필요 — 위 "저장 즉시 반영" 참고). 미발행·삭제된 블록은

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "type": "module",
   "description": "RootTale CMS MCP server and CLI for models, entries, exposures, media, integration docs, and public API access.",
   "bin": {