업그레이드 / 0.6, 0.7로 올리기
업그레이드 / upgrade-0-6
0.6, 0.7로 올리기
무엇이 바뀌었고 무엇을 실행할지, 그리고 cms_gaps를 지우기 전에 옮기는 법.
수정 2026년 11월 21일편집 docs seed버전 2
warning
0.5의 검색 gaps를 썼다면, 스키마를 바꾸기 전에 cms_gaps를 앱의 테이블로 복사하세요. Drizzle 스키마에서 cmsGaps를 빼면 drizzle-kit이 DROP TABLE을 만들 수 있어요.
새 패키지 이름#
이제 npmjs.com의 @mainsoft/agent-cms예요. .npmrc에서 @mainsoft-2024 줄을 지우고:
npm uninstall @mainsoft-2024/agent-cms
npm i @mainsoft/agent-cmsimport 경로는 범위만 바뀌어요. @mainsoft-2024/agent-cms/http는 @mainsoft/agent-cms/http가 돼요. 복사한 화면은 npx @mainsoft/agent-cms add --update를 실행하세요.
데이터베이스#
npx @mainsoft/agent-cms migrate check
npx @mainsoft/agent-cms migrate apply0.6은 열과 cms_audit 테이블을 더해요. 실행하기 전까지 CMS는 schema_outdated(503)로 답해요.
코드#
- 컬렉션마다
visibility: "public"또는"internal"이 필요하고, internal은access.read도 필요해요. - 오류:
error는 이제 세부 코드(conflict_version)이고, 예전 값은kind에 있어요. update는fields를 JSON Merge Patch로 다뤄요(null이면 키 삭제).- gaps는 라이브러리에서 빠졌어요.
onSearchMiss와 앱의 테이블을 쓰세요(검색 참고). - 함께 필요한
zod는^3.25또는^4예요.
cms_gaps 옮기기#
- 앱의 테이블을 만들어요(예:
app_search_misses). INSERT … SELECT한 번으로 행을 복사하고 개수를 비교해요.- 옮기는 동안
cms_gaps는 그대로 둬요. agent-cms는 이 테이블을 읽지도, 쓰지도, 지우지도 않고,doctor는 경고만 해요. - 새 검색 실패는
onSearchMiss로 모아요. - 더 필요 없을 때 마지막으로
cms_gaps를 지워요.
SQL 전체, Drizzle 테이블, onSearchMiss upsert 예시는 UPGRADE-0.6.md에 있어요.
0.7#
바꿀 것이 없어요. mcp: { anonymous: "read" }가 새로 생겼고 기본은 꺼져 있어요.