diff --git a/docs/sw/legacy-launcher-cleanup-merge-2026-10-22.md b/docs/sw/legacy-launcher-cleanup-merge-2026-10-22.md new file mode 100644 index 0000000..18b2cf2 --- /dev/null +++ b/docs/sw/legacy-launcher-cleanup-merge-2026-10-22.md @@ -0,0 +1,51 @@ +# 구형 실행 파일·PORTABLE 기록·ZIP 생성기 정리 main 병합 검증 (2026-10-22) + +웹 Storybook(`https://design.hmac.kr/`, `main` 배포본) 운영에 맞춰 더 이상 쓰지 않는 Windows 실행기, 루트 PORTABLE 검증 기록, 과거 ZIP 생성 스크립트를 삭제한 기록입니다. 컴포넌트 소스·CSS·Story·Theme·Public API·배포 설정(`.gitea/workflows`, Dockerfile, compose)은 그대로입니다. + +## 1. 병합 + +| 항목 | 값 | +|---|---| +| 1차 Commit | `f8cb5f8` chore: remove legacy Windows launcher and PORTABLE verification records | +| 2차 Commit | `9cdfdea` chore: remove unused portable preview and ZIP packaging scripts | +| main 병합 | `10a1dcd` → `bcec066` (no-ff, `chore/remove-legacy-launchers`) | +| 승인 기준 Commit | 이 보고서와 같은 테스트 전용 Commit (`approvedMainCommit` `fc856f5` → `bcec066`) | + +## 2. 삭제 파일과 근거 + +| 파일 | 근거 | +|---|---| +| `start-storybook.bat`, `scripts/start-storybook.mjs` | 웹 Storybook으로 대체. npm scripts·Workflow·Docker·다른 스크립트 참조 없음(`.mjs`는 BAT 전용) | +| `PORTABLE-R4/R5-CANDIDATE/R5/R6-VERIFICATION.md` | 2026-10-08 포터블 ZIP 검증 기록. README·AI 문서·CI·현재 검증 절차 참조 없음 | +| `scripts/portable-preview/` (`start-preview.bat`, `preview-server.cjs`) | `create-publisher-distribution.mjs`에서만 사용 | +| `scripts/create-publisher-distribution.mjs` | 2026-10-10 Publisher ZIP 생성기. npm scripts·Workflow·Docker·현재 안내 참조 없음 | +| `scripts/create-ai-reference-package.mjs` | 과거 AI Reference ZIP 생성기. `sync:ai-docs`/`check:ai-docs`(`scripts/ai-docs.mjs`)와 무관, 참조 없음 | + +남은 언급은 과거 기록(`docs/reports/gitea-source-inventory-2026-10-11.json`, `docs/guidelines/gitea-source-transfer-preparation-2026-10-11.md`, `portable-test-distribution.md` 등)이며 고치지 않았습니다. + +## 3. 문서 수정 (1차 Commit) + +- `README.md`, `docs/guidelines/publisher-distribution-guide.md`: BAT 실행 안내·"Storybook BAT 실행 분기" 섹션 제거, 일반 열람은 웹 Storybook, 로컬 개발은 `npm run storybook`. +- `.storybook/qa/LAN-PREVIEW.md`: 안내 문장 1곳(BAT → 웹 Storybook). +- `docs/reports/hmdesign-v2-final-baseline-2026-10-11.md`: 삭제 파일 링크 2개를 텍스트로 바꾸고 제거 사실만 덧붙임. + +## 4. 승인 기준 갱신 (`sw-test-regression-baseline-2026-10-20.md` §9) + +- `approvedMainCommit`: `fc856f5` → `bcec066`(테스트 전용 Commit, 보호 경로 변경 없음). 병합에 `.storybook/qa/LAN-PREVIEW.md` 문서 변경이 포함되어 미사용 검사의 `.storybook` 보호 경로 기준을 함께 옮깁니다. +- `public-api.approved.json` 유지(공개 `.d.ts` 바이트 동일). Story 변경이 없어 다른 승인 목록은 바꾸지 않았습니다. + +## 5. 검증 결과 (Node 22.23.2, `bcec066` + 기준 갱신, 증거는 저장소 밖 임시 폴더) + +| 검사 | 결과 | +|---|---| +| `npm run build-storybook` | 성공 | +| `npm run typecheck` | 성공 | +| Public API Guard | 7/7 PASS | +| home-menu-integration | 23/23 PASS | +| overview / overview overlays | 53/53, 20/20 PASS | +| storybook-unused-removal (Source Guard) | 94/94 PASS | +| `check:ai-docs` · `ai-docs.check.mjs` | PASS · 46/46 PASS | +| `scripts/check-doc-links.mjs` | exit 1 — 기존 문제 338건(중복 제외 335건), `10a1dcd`와 동일, 신규 0건 | +| npm scripts 대상 파일 | 누락 없음 | + +문서 링크 검사의 exit 1은 이번 변경 전부터 있던 문제이며 이 작업에서 고치지 않았습니다. diff --git a/packages/sw/tests/storybook-inventory.mjs b/packages/sw/tests/storybook-inventory.mjs index 05e8e78..497712c 100644 --- a/packages/sw/tests/storybook-inventory.mjs +++ b/packages/sw/tests/storybook-inventory.mjs @@ -77,7 +77,10 @@ export const integratedChangedFiles = [ // R1-R5 e267b1b; docs only, no source / CSS / Story change, public-api.approved.json kept). // -> fc856f5 (2026-10-22, Merge docs/sw-ai-usage-examples: user-approved AI_USAGE.md examples list A-J, 00180ba; // docs only, no source / CSS / Story change, public-api.approved.json kept). -export const approvedMainCommit = 'fc856f5e866575604b96a5a3bf2587b7a8dfd47e' +// -> bcec066 (2026-10-22, Merge chore/remove-legacy-launchers: user-approved removal of the legacy Windows launcher, +// PORTABLE records and ZIP packaging scripts, f8cb5f8 9cdfdea; docs/scripts only plus one .storybook/qa note, no +// source / CSS / Story change, public-api.approved.json kept). +export const approvedMainCommit = 'bcec066bda171242ce119a46d714b305a024dd92' // 170a5c2: the SW/Header sidebar page of the home menu (the moved verification Stories are movedHomeMenuIds). export const homeMenuSidebarIds = ['sw-header--home-menu'] // 6cf8854 SW Footer (current IDs after retiredFooterIds), 7f42923 viewer mode, 41e963a theme inheritance.