@utopia-studio-design/design-system-cli 0.6.1 → 0.7.0

package/data/docs/cer-016-023-round-6-repair.md

@@ -0,0 +1,92 @@
+# CER-016–023 — Round 6 repair and release record
+
+## Follow-up: CLI 0.6.1 published
+
+Website release: `dpl_7JpBZTg2P8GQ4qyFgdYGfg7RCozZ`,
+https://utopia-design-system-eubr2t13u-the-utopia-studio.vercel.app.
+Vercel confirmed Ready and the `design.utopia-studio.co` alias.
+
+The npm authentication blocker is resolved. Arc authentication completed and
+`npm whoami` confirmed `aiden2333`. The additional npm publish authentication
+also completed. **`@utopia-studio-design/design-system-cli@0.6.1` is public and
+is the `latest` dist-tag.** CER-022's generator correction is now published.
+
+This is a narrow patch built from the public 0.6.0 archive, preserving its seven
+starters and Ceramic 0.8.x dependency range. Only `package.json`,
+`bin/utopia-ds.mjs`, and `README.md` differ. Unreleased workspace 0.7.0/0.9.0
+features were not included. Chat Workspace, Quantum Verification Story and the
+three extra SaaS pages remain explicitly identified as unpublished previews.
+
+Verification completed before publication: all seven generation contracts,
+MCP 0.6.1 initialization and 18 tools, doctor, clean Dashboard/Composition
+installs and production builds. Actual static-build clicks verified
+`/visual-editor/`, reload, the fully initialized editor, Back to runtime, and
+the cross-template hosted Composer link.
+
+After publication, npm returned the exact tested SHA-512 integrity:
+`sha512-PXV03qmN793ipFLmtB94AQgECHQ5Miy+kY8MhwJEEvl7x8nSEhyxwTpafbiFDZSdkUsxAai8i0M3SxZGb85Usg==`.
+A fresh `npx --yes --package=@utopia-studio-design/design-system-cli@0.6.1
+utopia-ds template template-dashboard-composer --theme utopia-default --copy
+./dashboard` invocation generated the corrected link and the `^0.6.1` CLI
+dependency. The public-docs contract checker passed against the downloaded
+0.6.1 archive. The website snapshot and commands now reference 0.6.1 and the
+0.6.0 temporary workaround has been removed.
+
+The earlier record below describes the state before authentication was restored.
+
+---
+
+2026-09-05. Target: https://design.utopia-studio.co.
+
+Final production deployment: `dpl_22ahBGYPLtEmtkhy8HiXbSUqvLmo`,
+https://utopia-design-system-qug2oikgu-the-utopia-studio.vercel.app.
+Vercel Ready, aliased to the target domain. Frontend only; the live Clerk issuer
+and Ceramic production Convex were verified in the built entrypoint. No backend
+schema deployment, Git push, or npm publication occurred in this round.
+
+The website and public npm packages have separate release histories. The public
+registry was checked again: CLI **0.6.0**, design system **0.8.2**. Workspace
+0.7.0/0.9.0 must not be presented as already published.
+
+| Finding | Result |
+| --- | --- |
+| CER-016 | Docs and gallery use a checked-in snapshot of the public seven-template catalog and its page counts. Commands explicitly select CLI 0.6.0. Chat Workspace, Quantum Verification Story and the three extra SaaS pages are identified as unpublished web previews. This satisfies the reported unreleased-item alternative; it does not publish the two new templates. |
+| CER-017 | Official starter verification uses `npm run build` and runtime checks. `template validate` is explicitly scoped to community submissions with a separately authored `ceramic.template.json`. No fake community manifest is generated. |
+| CER-018 | Browser configuration no longer claims MCP connectivity. The prompt explains that public MCP 0.6.0 has no logo-registration tool and requires an independently verified integration for writes. The guide's nonpersistent registration button is disabled and its limitation is visible. |
+| CER-019 | Docs use published component/semantic names, including Button height roles, icon-size roles, focus-ring-width and shadow-popover. Unsupported universal roles were removed. Required-role chips are scoped to the published default CSS contract; theme-only and site-only roles are not represented as universal defaults. |
+| CER-020 | The website collects source paths as text. `.pptx/.potx` files are attached in the external production-agent session after copying the prompt. No browser upload is claimed. |
+| CER-021 | Source-authoring and asset prompts state the access prerequisite and explain how to request a GitHub invitation/approved branch or authorized archive from the Studio administrator. Public source access could not be verified; repository visibility was not changed. |
+| CER-022 | Workspace generator rewrites the selected template's URLs to its standalone root and other-template URLs to hosted previews. Build and actual clicks passed. **Public CLI correction remains pending publication**; the deployed docs provide the 0.6.0 direct `/visual-editor/` workaround and hosted Composer link. |
+| CER-023 | Asset contracts receive the output purpose. Marketing uses channels, dimensions, locales and variant filenames; presentation quotas and slide placement remain exclusive to presentation output. Theme prompt assembly lives in the domain layer. |
+
+## Verification
+
+- `npm run lint`, `npm run audit:semantic-pages`, and production Vercel build passed.
+- `npm run test:cli` passed, including CLI/MCP contracts and generated internal/external URL assertions.
+- `npm run test:cli:standalone` installed and built the generated Dashboard Composer and all three HTML entrypoints.
+- `npx vitest run src/domain/theme-handoff.test.ts`: 5 tests passed across source types, marketing/presentation and Arabic campaign guidance.
+- `node scripts/check-published-docs.mjs <extracted-public-cli-package> <extracted-public-system-package>` passed: public versions, full catalog equality, seven actual generation commands, HTML page counts, and documented token declarations.
+- In a clean temporary directory, the exact displayed `npx --yes --package=@utopia-studio-design/design-system-cli@0.6.0 utopia-ds template ...` command generated SaaS. `npm install` and `npm run build` passed; ten HTML pages were emitted.
+- A browser fixture loaded only public 0.8.2 `core.css` and `utopia-default.css`. All **51 distinct tokens** used in the 56 documented table rows had nonempty computed values. Examples: default Button 40px, small 32px, large 48px; focus width 2px.
+- Actual generated Dashboard link click reached `/visual-editor/`; reload completed with the Puck editor and “Registry connected” state. Generated Composition Registry's “Open live composer (hosted preview)” reached the production Composer.
+- On the deployed website, clicked all seven Docs template selectors and checked their versioned commands. Opened Create a Logo, selected ChatGPT and expanded the prompt; checked the truthful MCP limitation. Clicked HTML Presentations and confirmed the external attachment sequence. Selected Prism Mono → Create AI brief → Marketing assets → Review full prompt: channel/variant instructions and source prerequisites present; slide quotas absent.
+
+The generated browser fixture used workspace dependencies; the separate isolated
+standalone build and public npm SaaS consumer checks above did not substitute
+that fixture for an installation test. The whole 22-document / 113-link suite,
+all seven public consumer builds, real AI output generation and asset
+registration were not repeated in this repair run.
+
+## Remaining external release constraint
+
+`npm whoami` returned **401 Unauthorized**. No npm package was published. Restore
+npm publish authentication, complete the package release gates, publish the
+validated versions, and only then refresh `src/data/published-release.json` from
+the public tarballs. Do not mark CER-022's public package fix as closed until it
+is retested from npm. Existing unreleased workspace work was not blindly pushed
+or published.
+
+Rams `quick_review` was attempted on the changed UI files but the workspace's
+30 review credits are exhausted; no Rams score was obtained. Manual checks,
+type checks, semantic ownership audit and browser checks were used. No credit
+purchase or repository visibility change was made.

package/data/docs/cer-024-031-round-7-repair.md

@@ -0,0 +1,51 @@
+# Round 7 컴포넌트 수정·라이브 재검증
+
+2026-09-05. 대상: https://design.utopia-studio.co. Round 7 신규 CER-024–031 및 CER-013 Workspace Journey, CER-014 Textarea 추가 범위를 수정했다.
+
+배포: `dpl_46pRwpS8uLsjKHM6Xx3oULupJwas`, Vercel production Ready. 배포 URL: https://utopia-design-system-ikia7iet4-the-utopia-studio.vercel.app. 정상 도메인의 실제 로드 엔트리 `/assets/main-haDrz_94.js`까지 확인했다. 변경 중인 기존 작업 트리를 사용했으므로 git HEAD를 배포 소스의 정확한 SHA로 제시하지 않는다.
+
+## 변경과 실제 조작 결과
+
+| 결함 | 수정 | 라이브 1280×720 Chromium 재검증 |
+| --- | --- | --- |
+| CER-024 | 검색 입력의 활성 옵션·방향키·Enter 연결, 인스턴스별 ID, 선택 후 트리거 포커스 | Cal → ArrowDown → Enter로 Calendar 선택, expanded=false, 트리거 포커스 |
+| CER-025 | Drawer 선택 상태, 라디오 방향키·로빙 Tab, 로컬 완료 메시지와 닫기 연결 | ArrowDown으로 5:00 PM 선택·checked 변경. Confirm 후 Selected delivery time: 5:00 PM - 5:15 PM, Logical end로 포커스 복귀 |
+| CER-026 | workbench 방향·언어를 Drawer 포털에 전달 | LTR end x=832, RTL end x=0, 두 경우 폭 448. 최종 정지 후 측정 |
+| CER-027 | Sheet를 flex column으로 구성, Footer 정렬·크기 유지, 긴 내용 스크롤 | Close·Save 높이 각각 42px |
+| CER-028 | Tooltip의 고정 open 제거 | 키보드 포커스 시 tooltip 1개, Escape 애니메이션 종료 후 0개 |
+| CER-029 | 공용 ContextMenuTrigger에서 Shift+F10/ContextMenu 키 연결, 취소·disabled 처리 보존 | Shift+F10으로 Back menuitem 포커스. Escape로 Context menu preview 복귀 |
+| CER-030 | 두 Primitives 진입점의 콘텐츠 숨김·비활성화와 안정적인 aria-controls 연결 | expanded=false, 대응 콘텐츠 hidden=true, 높이 0, 숨긴 본문 비노출 |
+| CER-031 | Mobile Nav 프리뷰와 복사 예제에 Main navigation 이름, 실제 Trigger/Content 및 링크 추가 | dialog 이름 Main navigation, Docs/Components/Templates/Themes 링크. Escape 닫기 |
+| CER-013 추가 | WorkspaceJourney 실물 예제·선택 결과 제공 | Brief 선택 후 aria-current=step, Review/Publish disabled |
+| CER-014 추가 | Textarea의 고정 ID를 useId로 교체 | 각 입력 이름이 Project note / Required summary / Locked note로 한 번씩 읽힘. 두 프리뷰 간 ID 분리 |
+
+Drawer·Combobox·Mobile Nav·Workspace Journey 복사 예제도 함께 수정했다. Drawer 완료는 로컬 예제 상태이며 실제 예약·결제 요청은 발생시키지 않는다.
+
+## 검사
+
+- TypeScript 검사, semantic page ownership audit 통과.
+- component contract, motion contract, interaction contract 테스트 통과.
+- `node scripts/test-round-7-contracts.mjs` 통과. 두 export 진입점의 닫힌/열린 Collapsible, forceMount 상태의 hidden/inert·ID 연결과 Context Menu 취소·disabled 경계를 검사한다.
+- 프로덕션 Clerk 도메인과 Convex prod URL을 확인한 환경으로 Vercel production build 통과. Convex 변경·배포는 이번 라운드에 포함하지 않는다.
+- 독립 소비자에 로컬 npm tarball을 설치하고 Vite build 통과. 실제 브라우저에서 숨겨진 Nested action이 Tab 순서에서 제외되고 다음 Context target으로 이동함을 확인했다. Context Menu의 첫 command 포커스, 짧은 LTR/긴 RTL Sheet의 버튼 높이 40px, 긴 내용 스크롤을 확인했다.
+- Rams quick_review를 시도했으나 기존 30회 크레딧 소진 응답으로 실행되지 않았다. Rams 점수는 없다.
+
+## 범위
+
+후속 npm 게시 완료: `@utopia-studio-design/design-system@0.9.0`, `@utopia-studio-design/design-system-cli@0.6.2`를 public/latest로 게시했다. CLI 0.6.2는 생성 프로젝트 의존성을 ^0.9.0으로 올려 공용 컴포넌트 수정본을 설치한다. 공개 CLI의 7개 템플릿 카탈로그와 0.6.1 링크 수정은 보존했다.
+
+공개 레지스트리에서 두 tarball을 다시 내려받아 게시 파일의 integrity와 일치함을 확인했다. 별도 소비자 프로젝트에 registry URL의 0.9.0을 설치하고 Vite build 및 실제 브라우저에서 Collapsible의 숨김·Tab 제외, Context Menu 첫 항목 포커스, Sheet 푸터 버튼 40px를 재검증했다. 공개 CLI 7개 템플릿 생성·페이지 수·문서 토큰 계약 검사도 통과했다.
+
+- Design system integrity: `sha512-OmJu4hyLHuPfo6WivxY39b1ywbPUoaLCKiQL1fQmvdpuzp8YhV9BSR1dKb5qmS5sQXxZYQ+vkLd3R/hLEe5SCw==`
+- CLI integrity: `sha512-FkaimB9ofJvO1ECs8U+Dx1Dy9wYLpGRjsnPg7gCUG9N7yQW+RKrx3fScgK1n0aSs3rlho3Srk4wYZ1PUg1p8+Q==`
+
+라이브 실조작은 데스크톱 Chromium 1280×720에서 수행했다. 이번 수정 후 320/390 모바일 뷰포트, Safari/Firefox, 실제 음성 보조기술, 전체 테마·전체 컴포넌트 회귀 검사를 수행했다고 주장하지 않는다. 이전 CER-001–023 전체의 종결 판정이 아니다.
+
+검증 중 Tooltip 닫기 직후에는 종료 애니메이션 때문에 DOM이 잠시 남았으나 정지 후 제거됨을 별도 확인했다. Drawer 애니메이션 중 좌표는 최종 좌표 판정에서 제외했다.
+
+
+## npm 후속 게시 최종 확인
+
+`npx --yes --package=@utopia-studio-design/design-system-cli@0.6.2 utopia-ds template dashboard-composer --theme utopia-default --copy <새 폴더>`를 레포 밖에서 실행했다. 생성 프로젝트의 npm install 및 Vite build가 통과했고, lockfile의 실제 registry 의존성 design-system 0.9.0 / CLI 0.6.2를 확인했다.
+
+공개 버전 안내 갱신 후 웹 배포: `dpl_D87NHuhvhrszWq5pXKubw5duogoi`, https://utopia-design-system-58sk2d4hf-the-utopia-studio.vercel.app. Docs, Templates, Create a Logo의 공개 버전 안내 및 공개 토큰 스냅샷을 갱신했다.

package/data/docs/cer-033-035-036-round-12-repair.md

@@ -0,0 +1,37 @@
+# Round 12 — 잔여 UI·파일 검증 수정
+
+2026-09-06. 개발 챗의 수정 범위: CER-036 충돌 UI/Reload, CER-035 손상 이미지 등록·교체, CER-033 HTML 우선 표기. 별도 QA 챗의 독립 재검증을 대체하지 않는다.
+
+## 변경
+
+- 충돌 또는 저장 실패 시 성공 feedback을 지운다. 충돌 시 저장된 최신 snapshot을 다시 읽어 거부된 낙관적 값을 대체한다. 충돌한 상세 패널을 닫아 최신 목록과 경고를 노출한다. 기존에는 Reload가 모달 overlay 뒤에 있어 실제 클릭도 막혔다.
+- Reload는 window.location.reload에 의존하지 않고 진행 중 저장 큐를 정리한 뒤 IndexedDB의 최신 값을 읽어 rooms/requests와 변경 비교 기준을 함께 복원한다. 실패하면 저장 오류를 유지한다.
+- 이미지 파일은 실제 브라우저 Image.decode와 유효한 크기 확인을 통과해야 등록/교체한다. MIME 또는 알려진 이미지 확장자로 검사 대상을 판별한다. 손상 파일은 기존 파일·버전·승인 상태를 변경하지 않는다. 일반 source 파일 등록 정책은 유지한다.
+- 이미지 디코딩 중에도 등록 제출 잠금을 유지하고, 등록 창을 닫으면 늦게 끝난 검증 결과로 등록하지 않는다. 파일 교체는 가장 최근 선택만 반영한다.
+- Templates의 PPT 우선 eyebrow와 고정 12–15장 표기를 HTML·브리프 기준으로 바꾼다. Themes의 PPT / Presentation 표기를 HTML / Presentation으로 바꾼다.
+
+## 개발 검증 범위
+
+`tests/e2e/studio-round-10.spec.ts`에 충돌 직후 성공 메시지 제거·최신 값 표시·제품 Reload 클릭, 37바이트 손상 PNG 신규 등록 및 교체 거부 검증을 추가했다. 기존 다른 필드/자산 병합, 삭제 복원 차단, 10 MiB 반복 제출, 저장 실패 재시도와 DB 업그레이드 검사도 유지한다. 실제 사용자 프로필이 아닌 별도 테스트 컨텍스트의 fixture에서 실행한다.
+
+손상 이미지 거부는 이미지 디코딩 검사이며 PDF/PPT/모든 소스 파일 형식의 완전한 검증이나 보안 검사를 뜻하지 않는다. 서버 생성 Room·대표 로고 연결·SVG 변환 기능 공백은 수정 범위 밖이며 BLOCKED를 유지한다.
+
+Rams quick_review는 기존 크레딧 소진으로 리뷰를 반환하지 않았다.
+
+## 결과·배포
+
+- 개발 브라우저 검사: desktop/mobile Chromium 총 16개 통과.
+- 저장 규칙·프롬프트 테스트 25개 통과. TypeScript, semantic page ownership, 프로덕션 빌드 통과.
+- 개발 테스트에서 최초 충돌 Reload 클릭은 실제 overlay 차단으로 실패했고 제품을 수정했다. 별도 테스트 준비의 goto 직후 중복 reload 경합도 제거한 뒤 전체 16개를 다시 통과했다.
+- 이미지 디코딩은 `src/services/asset-file-validation.ts`, 파일 메타데이터의 순수 검사는 `src/domain/asset-file-validation.ts`에 둔다.
+- 배포 `dpl_9pzELTWtcxZgYPrvKrNxMoo2ZqAC`, Vercel Ready, design.utopia-studio.co 별칭 확인.
+- 라이브 엔트리 `/assets/main-X0Vn6xLq.js`. StudioConsolePage-DVs7D_OZ.js / TemplatesPage-DPwqzgId.js / ThemesPage-DSHYm_ew.js의 운영 응답 바이트가 로컬 배포 산출물과 SHA-256 기준 일치했다.
+- npm 패키지 및 Convex 백엔드 변경 없음. 운영 QA 자산을 수정하지 않았다.
+
+## QA 챗 재검증 요청
+
+1. CER-036: 같은 필드 충돌 직후 거부된 값·성공 안내가 사라지는지, 상세 패널이 닫힌 뒤 최신 목록이 표시되는지, 제품 Reload 클릭만으로 저장된 값을 유지하는지 검사한다. 다른 필드 보존·삭제 후 오래된 저장 거부도 회귀 확인한다.
+2. CER-035: 37바이트 손상 PNG를 신규 등록·정상 승인 자산 교체에 각각 사용한다. 거부 후 원본 파일·Version·Approved·다운로드 해시가 유지되는지 확인한다. 0바이트 및 정상 이미지 재선택 경로도 확인한다.
+3. CER-033: Templates의 HTML 우선 문구·브리프 기준 장수와 Themes의 HTML / Presentation 선택명을 확인한다. 실제 복사 프롬프트의 HTML 기본 산출물·명시 장수 우선순위가 유지되는지 확인한다.
+
+이 기록은 개발 검증·배포 완료이며 독립 운영 QA의 최종 종료 판정은 아니다.

package/data/docs/cer-035-037-round-10-repair.md

@@ -0,0 +1,34 @@
+# Round 10 — 파일·동시 수정 수정 기록
+
+2026-09-05. 범위: 로컬 Studio Console 자산 관리. Convex와 npm 공용 패키지는 변경하지 않는다.
+
+## 수정
+
+- CER-036: IndexedDB readwrite 트랜잭션 안에서 최신 snapshot을 읽고, 해당 탭의 마지막 저장 기준과 현재 변경분을 비교해 필드 단위로 병합한다. rooms/assets/requests 등 ID 기반 배열은 레코드 단위로 병합한다. 다른 필드·다른 자산·다른 탭의 추가 항목을 보존하며, 같은 필드의 상충하는 값과 삭제 후 오래된 수정은 전체 트랜잭션을 중단한다. 동시 파일 교체와 보지 못한 새 파일 버전의 승인도 거부한다. 충돌은 새로고침 안내, 저장 실패는 명시적인 재시도를 제공한다. 서버 동시성 수정으로 주장하지 않는다.
+- CER-037: 등록 양식의 동기 ref 잠금과 disabled 버튼으로 재렌더 이전의 Enter/포인터 반복 제출도 차단한다. 저장 오류가 나면 이미 준비된 변경을 재시도하며 새 레코드를 추가 생성하지 않는다.
+- CER-035 확장: 공통 파일 검사에서 0바이트를 거부한다. 등록과 Replace file에 적용하며, 잘못된 교체에서는 blob·버전·승인 상태를 변경하지 않는다. 손상 파일 탐지/전체 파일 형식 검증까지 완료한 것은 아니다.
+
+## 검증
+
+- `src/domain/studio-snapshot-merge.test.ts`: 9개 통과. 다른 필드/자산/추가 항목 보존, 같은 필드 충돌, 삭제된 자산·룸의 오래된 수정 거부, 변경된 자산의 오래된 삭제 거부, 파일 버전 충돌, 0바이트 및 10 MiB 입력 경계.
+- `tests/e2e/studio-round-10.spec.ts`: 별도 브라우저 컨텍스트의 개발 프리뷰 fixture 사용. 실제 사용자의 QA Orbit 및 정상 로고는 변경하지 않는다. UI를 통해 두 탭 수정/삭제, 10 MiB Enter·더블클릭, 빈 파일 등록/교체, 승인 상태·버전의 reload 유지, 다른 자산 동시 수정, IndexedDB 실패 주입 후 재시도를 검사한다.
+- TypeScript, semantic page ownership audit, 프로덕션 빌드 통과.
+- Rams quick_review 호출은 기존 크레딧 소진 응답을 반환했다. 디자인 리뷰 점수 없음.
+
+브라우저 테스트 준비 중 같은 URL의 goto가 실제 reload를 일으키지 않아 모달이 남는 테스트 문제를 수정했다. Vercel 빌드와 병행했던 개발 서버 검사에서는 HMR로 화면이 교체되어 중단하고, 빌드 종료 후 다시 실행했다.
+
+운영 서버 장애·결제·다른 계정 접근 격리·전체 37건 회귀검증은 이번 범위에 포함하지 않는다. 모바일 Chromium 검사는 실제 iOS/WebKit이나 스크린리더 검증을 대신하지 않는다.
+
+## 최종 결과 및 운영 재검증
+
+- 로컬 브라우저: desktop/mobile Chromium 각 8개, 총 16개 통과. 도메인 9개와 합계 25개.
+- DB 버전 2는 기존 저장소와 blob을 유지한다. 버전 1을 지정해 여는 이전 코드의 저장은 VersionError로 거부한다. 마이그레이션 보존/이전 writer 거부를 두 브라우저 프로젝트에서 검사했다.
+- 운영 배포 `dpl_4JT3MbY7iigktLhrMoSQJP3qy5SU`, 엔트리 `/assets/main-CSDCLJnH.js`, Vercel Ready 및 design.utopia-studio.co 별칭 확인.
+- 운영 in-app browser 1280×720, 기존 관리자, 같은 프로필의 두 탭. QA Orbit에 이번 검증용 임시 자산만 등록했다.
+- CER-036: A 이름 `QA R10 renamed A`와 B 정책 `QA R10 policy B`가 새로고침 후 함께 유지됐다. A 삭제 후 B 오래된 정책 저장은 `Changes were not saved` / `Another tab changed the same field or deleted this item`로 거부됐고 다시 나타나지 않았다. 별도 이름 충돌에서 A의 `QA R10 winner`가 유지됐으며 B의 `QA R10 stale`은 거부됐다.
+- CER-037: 운영에서 10 MiB source.bin의 Enter 연타 및 작은 SVG의 포인터 더블클릭 모두 자산 1개만 추가됐다. 로컬에서는 10 MiB로 두 입력 방식을 모두 검사했다.
+- CER-035 확장: 임시 SVG를 승인한 뒤 empty.png로 Replace file을 시도하면 `Empty files cannot be used`를 표시했고, Approved / Version 1 / scratch.svg / 111 B를 유지했다. 원래 정상 QA 로고 파일은 교체하지 않았다.
+- 검증용 세 자산(`QA R10 repair scratch`, `QA R10 validation scratch`, `QA R10 keyboard scratch`; 변경된 이름 포함)을 모두 삭제했다. 충돌 탭은 닫았다.
+- 최종 운영 새로고침 후 `.studio-asset-grid article` count=1, storage=ready. `QA Orbit logo v2 — QA ONLY` 한 개와 Approved 상태만 남았음을 실제 UI로 확인했다.
+
+판정: 요청된 CER-036·037 및 CER-035의 0바이트 교체 범위 PASS. 전체 37건이나 파일 보안·형식 검증 전체의 종료 판정은 아니다.

package/data/docs/charts.md

@@ -16,6 +16,15 @@ different `ChartRenderer` without replacing Ceramic's series identities, states,
 keyboard model, summary, legend, exact-value output, RTL behavior, or semantic
 tokens.
 
+## Appearance presets
+
+Use `appearance="mono-rounded"` for a restrained monochrome palette and rounded
+line, bar, area, scatter, and donut geometry adapted from
+[Amicro Monocharts](https://amicro.vercel.app/mono-charts). The preset changes
+presentation only: semantic series IDs, patterns, exact values, states,
+keyboard exploration, RTL behavior, and reduced-motion handling remain owned by
+`ChartRoot`. The default remains `appearance="default"`.
+
 ## Data and series identity
 
 Every period and series needs a stable ID. Missing values use `null`; never
@@ -31,6 +40,14 @@ const data: ChartDatum[] = [
   { id: 'jan', label: 'Jan', values: { current: 42, previous: 35 } },
   { id: 'feb', label: 'Feb', values: { current: 46, previous: null } },
 ]
+
+<ChartRoot
+  accessibleSummary="Monthly performance compared with the benchmark."
+  appearance="mono-rounded"
+  data={data}
+  series={series}
+  title="Performance overview"
+/>
 ```
 
 ## Required states
@@ -53,9 +70,23 @@ in the live explorer and table, and does not imply zero.
 
 ## Chart families
 
-The default renderer supports `line`, `bar`, `area`, `stacked`, `scatter`, and
-`donut`. Products should choose the family from the analysis task rather than
-from visual preference.
+The default renderer supports 26 families:
+
+- Cartesian and comparison: `line`, `bar`, `area`, `stacked`, `scatter`,
+  `composed`, `step`, `range`, `waterfall`, and `stream`.
+- Radial and progress: `donut`, `radial`, `gauge`, `meter`, `polar`, `radar`,
+  and `bullet`.
+- Distribution and hierarchy: `bubble`, `heatmap`, `treemap`, `funnel`, and
+  `pyramid`.
+- Flow, finance, and compact reporting: `sankey`, `candlestick`, `sparkline`,
+  and `kpi`.
+
+Specialized families retain the common `ChartDatum` model. `candlestick` uses
+series IDs `open`, `high`, `low`, and `close`; `range` uses its first two
+series as lower/upper values; `bubble` uses the second series as size;
+`heatmap` treats data as rows and series as columns; and `sankey` treats the
+first datum's series values as source flows. Products should choose the family
+from the analysis task rather than visual preference.
 
 ## Copyable blocks
 

package/data/docs/chat-service-methodology.md

@@ -0,0 +1,181 @@
+# Ceramic chat service methodology
+
+Ceramic chat surfaces are task workspaces, not transcripts placed inside a
+marketing page. The reusable contract separates conversation, governed tools,
+and generated output so a team can build an assistant, support product, or
+collaboration service without inventing scroll, composer, RTL, and streaming
+behavior on every page.
+
+## The three-layer model
+
+1. **Conversation** owns chronological user and assistant messages, truthful
+   execution activity, choices, source intake, and governed tools.
+2. **Composer** stays docked to the conversation and owns text entry,
+   attachments, send/stop state, and input recovery.
+3. **Output** presents generated previews, files, and approved artifacts beside
+   the conversation. It starts empty and never fabricates a result.
+
+Search, connection, configuration, and approval are inputs, so they use
+`ChatToolPanel` inside the conversation. A generated logo, page, document, or
+other durable result belongs in the product's output rail.
+
+## Structure substantive assistant responses
+
+Keep Markdown as the durable browser/API/MCP payload, then render its semantic
+structure instead of placing a long string inside a large assistant bubble. A
+design recommendation should normally contain:
+
+- one decisive opening recommendation and short rationale;
+- `Recommended direction` with concrete visual changes;
+- `Suggested palette` with named `#RRGGBB` values when color is relevant;
+- `Values expressed through the mark` with an explicit value-to-evidence link;
+- `Logo quality check` with visual evidence when the artifact is a logo;
+- no more than two unresolved decisions; and
+- one concrete next step.
+
+Logo-specific quality gates and proof-sheet requirements are defined in
+[`logo-maker-methodology.md`](./logo-maker-methodology.md).
+
+Use headings, paragraphs, lists, inline emphasis, code values, and generous
+rhythm rather than converting every section into a card. A response may embed a
+compact, synchronized view of actual generated variants so the rationale and
+artifact can be read together; the output rail remains the source of truth for
+selection review and approval. Never fabricate a preview, file link, elapsed
+time, or tool result to make a response appear richer.
+
+## Choose the scroll owner first
+
+Use `ChatLayout scrollMode="managed"` for a viewport-height product workspace.
+The managed `ChatMessageScroller`:
+
+- enters at the latest message;
+- follows streamed content only while the user remains at the live edge;
+- stops following when the user scrolls back to read;
+- shows a localized jump-to-latest action when new content is offscreen;
+- preserves the reading position when older history is prepended;
+- exposes a named `region` and an updating `log` to assistive technology.
+
+Use `scrollMode="static"` only when a short transcript intentionally participates
+in document scrolling. Never give both the page and the conversation vertical
+scroll ownership.
+
+## Reference template
+
+```tsx
+import {
+  ChatComposer,
+  ChatComposerInput,
+  ChatLayout,
+  ChatMessage,
+  ChatMessageBubble,
+  ChatMessageList,
+  ChatSendButton,
+  ChatToolPanel,
+} from '@utopia-studio-design/design-system/Chat'
+import { AttachmentTrigger } from '@utopia-studio-design/design-system/Attachment'
+
+export function AssistantWorkspace({ messages, isStreaming, send }) {
+  return (
+    <ChatLayout
+      density="compact"
+      isStreaming={isStreaming}
+      jumpToLatestLabel="Jump to latest message"
+      messagesLabel="Support conversation"
+      scrollMode="managed"
+      messages={
+        <ChatMessageList>
+          {messages.map((message) => (
+            <ChatMessage
+              anchor={message.role === 'user'}
+              key={message.id}
+              messageId={message.id}
+              role={message.role}
+            >
+              <ChatMessageBubble role={message.role}>
+                {message.text}
+              </ChatMessageBubble>
+            </ChatMessage>
+          ))}
+          <ChatMessage role="assistant">
+            <ChatToolPanel
+              count="15K"
+              description="Search and add evidence to the current request."
+              title="Reference library"
+            >
+              {/* Product-owned search and selection controls */}
+            </ChatToolPanel>
+          </ChatMessage>
+        </ChatMessageList>
+      }
+      composer={
+        <ChatComposer
+          actions={<ChatSendButton label="Send message" />}
+          onSubmit={send}
+          toolbarStart={<AttachmentTrigger aria-label="Add attachment" />}
+        >
+          <ChatComposerInput aria-label="Message" />
+        </ChatComposer>
+      }
+    />
+  )
+}
+```
+
+All visible labels in the example are product localization inputs. Arabic uses
+the same chronological DOM order and inherits `dir="rtl"`; Ceramic mirrors
+logical alignment and control placement without reversing time.
+
+## Composer behavior
+
+- The textarea grows with content until its semantic maximum height, then owns
+  its internal overflow.
+- `Enter` submits and `Shift+Enter` inserts a newline. IME composition never
+  submits early.
+- Selected attachment previews appear in `ChatComposerDrawer` above the input.
+  Put the upload or add trigger in `toolbarStart`, opposite the send/stop actions,
+  so the composer remains one compact surface. Expose format or size limits to
+  assistive technology instead of adding a persistent explanatory row.
+- A running request changes the product action from Send to Stop. Do not present
+  an enabled Send action while the product cannot accept another request.
+- Persist unsent text and attachments when route recovery is a product
+  requirement; persistence belongs to the application, not the component.
+
+## Tool behavior
+
+`ChatToolPanel` is collapsed by default unless the tool is the user's immediate
+blocking task. Its summary contains one factual title, optional one-line
+description, and a truthful count or state. Expanded content has bounded
+internal overflow so it cannot push the composer out of reach.
+
+After a tool completes, prefer a compact summary such as “3 references added”
+with an Edit affordance. Keep generated output out of the tool panel.
+
+The same conversation must remain operable through MCP without inventing a
+second UX state machine. Product tool inputs and states use stable ids from a
+shared manifest; MCP returns the same prompt, reference policy, next step, and
+approval requirement that the browser consumes. For Logo Maker this sequence
+is `get_room_context` → `list_logo_skills` → `prepare_logo_maker_run` → draft →
+human review → authenticated checkpoint. A local preparation tool never claims
+that the remote run or checkpoint has happened.
+
+## shadcn and AI component relationship
+
+Ceramic follows the headless behavior and composition discipline of current
+shadcn chat primitives, but does not copy Tailwind classes, raw theme colors,
+or product copy. Ceramic owns semantic tokens, slots, states, motion profiles,
+Arabic/RTL behavior, package exports, and QA contracts. Use shadcn or AI
+Elements examples as behavior references; use Ceramic components as the public
+runtime contract.
+
+## Release checklist
+
+- Desktop, mobile, and the changed breakpoint have one clear scroll owner.
+- English/LTR and Arabic/RTL preserve order, alignment, labels, and truncation.
+- Pointer, keyboard, touch, screen-reader semantics, and IME submission work.
+- Streaming, offscreen update, history prepend, reload, empty, error, and long
+  content states recover without a viewport jump.
+- Normal and reduced motion preserve the same final state.
+- Tool inputs remain in conversation; generated output remains in the output
+  rail.
+- Components, manifests, docs, exports, CLI/MCP data, contract tests, and browser
+  tests agree before publishing.

package/data/docs/code-block.md

@@ -0,0 +1,20 @@
+# Code Block
+
+Use `CodeBlock` for independently reusable commands, configuration, source, and agent instructions.
+
+```tsx
+import { CodeBlock } from '@utopia-studio-design/design-system/CodeBlock';
+
+<CodeBlock
+  code="npm install @utopia-studio-design/design-system"
+  language="bash"
+  copyLabel="Copy code"
+  copiedLabel="Code copied"
+/>
+```
+
+The visible snippet and clipboard value come from the same `code` string. The copy action exposes an accessible name, a visible focus ring, a minimum touch target, and polite success feedback. Supply localized `copyLabel` and `copiedLabel` values in localized products.
+
+The component uses semantic surface, foreground, muted foreground, border, success, radius, typography, spacing, icon, and focus tokens. Its header follows logical inline direction. Source and command content remain LTR in Arabic and RTL layouts so exact code stays stable.
+
+Do not add a second copy control outside `CodeBlock`, hardcode brand colors, or use it for editable content.

package/data/docs/creative-production.md

@@ -0,0 +1,149 @@
+# Presentation and marketing production
+
+Ceramic supplies the semantic theme, registered brand assets, production
+constraints, and a copyable prompt. The website does **not** create a PPTX or
+campaign export merely because a user selects an output. Run the copied prompt
+in an agent or tool that can read the supplied files, create artifacts, and
+open the results for inspection.
+
+## Create a presentation
+
+1. Open **Templates → Presentations → Presentation Studio**.
+2. Choose the deck purpose, theme source, and deliverables.
+3. When reusing a deck system, attach the approved `.pptx` or `.potx` source.
+4. Keep `public/media` as the default image source, or provide a read-only
+   GitHub asset repository with `ceramic.assets.json`.
+5. Review and copy **Full creation prompt**. The short template-card copy is
+   not the production prompt.
+6. Paste the prompt into a presentation-capable agent and attach the brief,
+   evidence, template, logo, fonts, images, and data sources.
+7. Approve the slide outline before visual production.
+8. Require an editable PPTX, review PDF, source files, asset report, and QA
+   report.
+
+The creation agent must keep unsupported claims as `[NEEDS INPUT]`. It must not
+invent metrics, citations, testimonials, logos, or Arabic production copy.
+
+### Presentation inputs
+
+- Story: audience, meeting goal, core message, evidence, and final ask.
+- Theme: a registered Ceramic theme, brand repository, or approved PPT source.
+- Identity: registered logo or wordmark, fonts, and usage policy.
+- Imagery: licensed assets from `public/media` or the external asset manifest.
+- Data: a traceable source for every number and chart.
+
+### Presentation delivery gate
+
+- Open both PPTX and PDF; a successful file write is not proof of a valid deck.
+- The registered logo appears on cover and closing slides, keeps its aspect
+  ratio, and remains vector when the format supports it.
+- Every slide is legible at 16:9 with no overflow, clipping, accidental font
+  substitution, or unreadably small text.
+- Editable information uses native shapes and charts where editing matters.
+- Arabic uses approved copy, `dir="rtl"`, logical alignment, Arabic type roles,
+  and verified mixed-script and numeral behavior.
+- The asset report lists source, license, output format, and slide numbers.
+
+## Create marketing assets
+
+1. Open **Themes**, choose the permitted theme, then choose **Use with AI →
+   Marketing Assets**. Signed-in users may start from the Brand Workspace.
+2. Supply one approved campaign brief: goal, audience, message, proof, CTA,
+   channels, dimensions, deadline, and approval state.
+3. Attach the approved logo, real product screenshots, licensed imagery, and
+   localized copy.
+4. Copy the generated production prompt into a file-capable creation tool.
+5. Create one semantic master and derive the requested channel variants.
+6. Inspect every export independently before release.
+
+### Marketing outputs
+
+- Editable master with content separated from layout.
+- Explicit channel variants such as 1:1, 4:5, 9:16, and 16:9.
+- Clear file names containing campaign, channel, locale, and version.
+- Metadata for source, license, locale, version, and approval state.
+- QA results for safe area, crop, contrast, copy, file size, and RTL.
+
+Never fabricate a product screenshot, performance claim, testimonial,
+partnership, or localized production sentence. Keep missing approved content as
+`[NEEDS INPUT]`.
+
+## Asset repository contract
+
+Read `presentation-asset-repository.md` for the complete schema. The generator
+may read images and manifest metadata but must never execute code from an asset
+repository. Select imagery by subject, mood, orientation, and focal point, not
+as random decoration.
+
+---
+
+# إنتاج العروض ومواد التسويق
+
+يوفّر Ceramic الثيم الدلالي وأصول العلامة المسجلة وقيود الإنتاج وموجّها قابلا
+للنسخ. الموقع **لا ينشئ** ملف PPTX أو صور الحملة بمجرد اختيار نوع المخرج. يجب
+تشغيل الموجّه المنسوخ في وكيل أو أداة تستطيع قراءة الملفات وإنشاء المخرجات
+وفتحها للفحص.
+
+## إنشاء عرض تقديمي
+
+1. افتح **القوالب ← العروض التقديمية ← Presentation Studio**.
+2. اختر هدف العرض ومصدر الثيم والمخرجات المطلوبة.
+3. عند إعادة استخدام نظام عرض، أرفق ملف `.pptx` أو `.potx` المعتمد.
+4. استخدم `public/media` كمصدر افتراضي للصور، أو أدخل مستودع GitHub للقراءة
+   فقط يحتوي `ceramic.assets.json`.
+5. راجع وانسخ **موجّه الإنشاء الكامل**. وصف بطاقة القالب ليس موجّه الإنتاج.
+6. ألصق الموجّه في وكيل يدعم إنشاء العروض وأرفق الموجز والأدلة والقالب والشعار
+   والخطوط والصور ومصادر البيانات.
+7. وافق على مخطط الشرائح قبل بدء التصميم.
+8. اطلب PPTX قابلا للتحرير وPDF للمراجعة وملفات المصدر وتقرير الأصول وتقرير QA.
+
+يجب أن يترك الوكيل الادعاءات غير المدعومة بعلامة `[NEEDS INPUT]`. لا يجوز له
+اختلاق الأرقام أو المراجع أو الشهادات أو الشعارات أو النص العربي النهائي.
+
+### مدخلات العرض
+
+- القصة: الجمهور وهدف الاجتماع والرسالة الأساسية والأدلة والطلب النهائي.
+- الثيم: ثيم Ceramic مسجل أو مستودع علامة أو مصدر PPT معتمد.
+- الهوية: الشعار أو wordmark والخطوط وسياسة الاستخدام.
+- الصور: أصول مرخصة من `public/media` أو manifest المستودع الخارجي.
+- البيانات: مصدر قابل للتتبع لكل رقم ورسم.
+
+### بوابة تسليم العرض
+
+- افتح PPTX وPDF فعليا؛ نجاح كتابة الملف لا يثبت صلاحية العرض.
+- يظهر الشعار المسجل في الغلاف والخاتمة ويحافظ على نسبته ويبقى متجها عندما
+  تدعم الصيغة ذلك.
+- تبقى كل شريحة مقروءة بنسبة 16:9 من دون overflow أو قص أو استبدال خط غير مقصود
+  أو نص صغير جدا.
+- تستخدم المعلومات التي تتطلب التعديل أشكالا ورسومات أصلية.
+- تستخدم العربية نصا معتمدا و`dir="rtl"` ومحاذاة منطقية وأدوار الطباعة العربية،
+  مع فحص النص المختلط والأرقام.
+- يسجل تقرير الأصول المصدر والترخيص والصيغة النهائية وأرقام الشرائح.
+
+## إنشاء مواد تسويقية
+
+1. افتح **Themes** واختر الثيم المسموح، ثم **Use with AI ← Marketing Assets**.
+   يمكن للمستخدم المسجل البدء من Brand Workspace.
+2. قدّم موجز حملة واحدا معتمدا: الهدف والجمهور والرسالة والدليل وCTA والقنوات
+   والمقاسات والموعد وحالة الموافقة.
+3. أرفق الشعار المعتمد ولقطات المنتج الحقيقية والصور المرخصة والنص الموطّن.
+4. انسخ موجّه الإنتاج إلى أداة إنشاء تستطيع التعامل مع الملفات.
+5. أنشئ master دلاليا واحدا ثم اشتق نسخ القنوات المطلوبة.
+6. افحص كل ملف تصدير بصورة مستقلة قبل النشر.
+
+### مخرجات التسويق
+
+- master قابل للتحرير يفصل المحتوى عن التخطيط.
+- نسخ صريحة للقنوات مثل 1:1 و4:5 و9:16 و16:9.
+- أسماء ملفات واضحة تتضمن الحملة والقناة واللغة والإصدار.
+- بيانات وصفية للمصدر والترخيص واللغة والإصدار وحالة الموافقة.
+- نتائج QA للمساحة الآمنة والقص والتباين والنص وحجم الملف وRTL.
+
+لا تختلق لقطة منتج أو ادعاء أداء أو شهادة أو شراكة أو نصا عربيا نهائيا. اترك
+المحتوى الذي لم يعتمد بعد بعلامة `[NEEDS INPUT]`.
+
+## عقد مستودع الأصول
+
+اقرأ `presentation-asset-repository.md` لمعرفة المخطط الكامل. يمكن للمولّد قراءة
+الصور وبيانات manifest، لكنه لا ينفذ أي كود من مستودع الأصول. اختر الصور حسب
+الموضوع والمزاج والاتجاه ونقطة التركيز، لا كزخرفة عشوائية.