11월 20일
📌 v1.101.9: auto-registered
11월 4일
# Clinic-OS v1.100.3 릴리스 노트
배포일: 2026-11-03
v1.99.6 이후 버전을 받은 병원에서 `npm run deploy` 가 시작 직후 멈추던 문제를 고친 긴급 수정입니다. v1.100.2의 모든 내용을 포함합니다.
## 1. Cloudflare 로그인만 쓰는 병원의 배포가 멈추던 문제 수정
`npx wrangler login` 으로 로그인해 `CLOUDFLARE_API_TOKEN` 환경변수 없이 배포하는 병원에서, 배포 점검이 "Pages 프로젝트 조회에 필요한 인증 정보가 없다"며 멈췄습니다. 이제 인증 정보가 없거나 Cloudflare 조회가 일시적으로 실패하면 점검을 건너뛰고 배포를 계속하며, 마지막에 "주의: 확인할 항목이 있습니다" 목록에 한 줄이 표시됩니다(종료 코드 2, 실패 아님). 같은 내용이 본사에도 전달됩니다.
- **그대로 멈추는 경우:** 조회가 정상으로 끝났는데 배포 대상 프로젝트 이름이 다르거나, `wrangler.toml` 의 `CLOUDFLARE_URL` 이 해당 프로젝트에 연결된 도메인이 아니거나, Preview 주소가 해당 프로젝트 것이 아닌 경우(다른 병원 사이트에 잘못 올리는 사고를 막기 위한 것).
- 관리자 화면의 사이트 주소가 프로젝트에 연결된 도메인과 다르면, 멈추지 않고 경고만 표시합니다.
## 2. 인수인계 패키지의 비밀번호 검사 기준 복원
인수인계 파일 묶음을 만들 때 `admin_password`, `temporary_password` 값이 12자 이상 문자열이면 다시 차단합니다(v1.100.2 에서는 32자 미만이 통과했습니다). 토큰 계열(`installation_token`, `device_token`, `CLOUDFLARE_API_TOKEN`)은 32자 이상일 때만 차단하며, 짧은 공개 점검용 예시 값은 통과합니다.
## 업데이트 후 할 일
- 모든 병원: `npm run update:starter` 후 평소처럼 배포합니다.
- v1.99.6 이상을 받은 뒤 배포가 "인증 정보" 오류로 멈췄던 병원: 업데이트 후 같은 명령을 다시 실행하세요.
11월 4일
📌 v1.100.4: auto-registered
11월 3일
🐛 continue bundled stable updates after completed gate warnings
11월 2일
🐛 distinguish generated mirror state from dirty Starter source
11월 2일
🐛 classify Cloudflare preflight400 and retry transient network failures
11월 2일
🐛 verify independent Starter build provenance before approval
11월 2일
🐛 retain recovery hashes through v1.99.7 before publishing
11월 2일
📌 v1.99.7: auto-registered
11월 1일
🔧 retain recovery hashes through v1.99.2
11월 1일
# Clinic-OS v1.99.1 릴리스 노트
배포일: 2026-11-01 (베타 채널)
이 버전은 v1.99.0(내부 베타)의 내용을 모두 포함하며, 아래 5번 수정이 추가됐습니다. v1.99.0은 5번 문제 때문에 안정 채널로 올리지 않았습니다.
## 1. 배포 중 확인 항목이 "차단"에서 "경고"로 바뀝니다
`npm run deploy`, `core:pull`, `update:starter` 가 실행 중 점검에서 문제를 발견하면, 이제 실제 피해가 생기는 경우에만 작업을 멈춥니다.
- **그대로 멈추는 경우:** 데이터 손실 위험, 배포 후 사이트가 실제로 열리지 않는 경우(운영 화면·워커 응답 확인 실패), 다른 병원 데이터를 덮어쓰는 경우, 비밀정보 노출, 의료광고·약관 등 법적 금지 규칙 위반, 실행 파일·설정 파일 무결성 불일치.
- **경고로 바뀌는 경우:** 그 밖의 점검 항목(사이트맵 차이, 시각 비교, 이미지 경로, 워커 크기 측정 등). 작업은 끝까지 진행되고, 마지막에 "주의: 작업은 완료됐지만 확인할 항목이 있습니다" 목록이 한국어로 출력됩니다. 같은 내용이 본사에도 전달됩니다(전송이 안 돼도 작업은 계속됩니다).
- **실행 결과 코드:** 경고만 있었던 작업은 종료 코드 2로 끝납니다(실패 아님). 자동화 스크립트가 0만 성공으로 보고 있다면 2도 "완료, 확인 필요"로 처리하세요.
- 특정 점검을 예전처럼 차단으로 되돌리려면 `scripts/local/gate-policy.json` 에 해당 항목 한 줄을 적습니다(전체를 되돌리려면 `{"gate_policy":{"default":"block"}}`). 이 파일은 `core:pull` 이 건드리지 않습니다.
## 2. 병원이 직접 등록한 스킬이 업데이트 후 사라지던 문제 수정
`update:starter` 가 스킬 목록(`.agent/skill-registry.json`)을 통째로 바꿔서, 병원이 직접 만든 스킬 등록이 빠지던 문제를 고쳤습니다. 이제 병원 고유 스킬(명령 파일이 남아 있는 항목)은 업데이트 후에도 목록에 유지됩니다. 이미 사라진 항목은 직전 백업(`.core-backup`)의 이전 목록에서 다시 등록해야 합니다.
## 3. 커스텀 도메인 연결 안내 정리
`docs/CUSTOM_DOMAIN_GUIDE.md` 를 실제 절차에 맞췄습니다.
1. 네임서버를 Cloudflare로 옮기고 Pages 커스텀 도메인에 `www` 와 루트 도메인을 모두 추가합니다.
2. 보호 파일 `wrangler.toml` 의 `[vars]` 에서 `CLOUDFLARE_URL = "https://www.<도메인>"` **한 줄만** 설정하고 배포합니다(도메인 연결 시 1회).
3. 루트 도메인과 pages.dev 주소가 www 로 301 이동하는지, canonical 과 `sitemap-index.xml` 이 www 주소인지 확인합니다.
4. 관리자 화면의 사이트 설정에 같은 주소를 저장합니다.
5. 이전 사이트의 주요 주소(검색 노출 상위 20~50개)를 본사에 전달하면 이동 방법을 안내합니다.
6. 메일(MX/SPF) 기록은 그대로 둡니다.
`config.ts` 수정 단계는 현재 설치에 해당하지 않아 삭제했습니다.
## 4. 보호 파일 수정이 허용되는 절차를 한 표로 정리
`.claude/rules/clinic-os-safety.md` 에 "허용된 예외" 표가 추가됐습니다(도메인 주소 한 줄, 최초 설정, D1/R2 복구, DB 연결 복구, 온보딩 상태, 예전 관리자 비밀번호 줄 삭제 등). 각 안내문과 배포 가드 메시지가 해당 예외 이름을 함께 알려 주므로, 안내를 따르다 "수정 금지" 규칙과 부딪혀 멈추는 일이 줄어듭니다.
## 5. 공개 화면 점검(비공개 키 검사)이 정상 파일을 "키 노출"로 오인해 배포를 막던 문제 수정
v1.99.0의 배포 전 점검이 `risk-...`·`task_...` 같은 일반 주소/식별자, 이미지 변환용 내장 데이터, `password:"[type=password]"` 같은 화면 선택자 문구를 비공개 키로 잘못 판단해 `npm run deploy` 를 멈추게 할 수 있었습니다. 이제 실제 키 형태(AWS `AKIA…`, GitHub `ghp_…`, `sk-`/`sk_live_` 계열, 비밀번호·토큰 대입값, 개인키 PEM 본문)만 차단하고, 일반 파일은 통과시킵니다. 실제 키가 공개 파일에 들어 있으면 예전처럼 반드시 차단됩니다(이 차단은 경고로 낮출 수 없습니다).
## 업데이트 후 할 일
- 보통 병원: `npm run update:starter` 후 평소처럼 배포합니다. 달라지는 점은 위 1번의 경고 목록과 종료 코드 2뿐입니다.
- 커스텀 도메인을 연결하는 병원: 위 3번 순서로 진행하세요.
- 스킬이 사라졌던 병원: `.core-backup` 의 이전 스킬 목록을 보고 병원 고유 스킬을 다시 등록하세요(다음 업데이트부터는 유지됩니다).
11월 1일
📌 v1.99.2: auto-registered