test(sw): approve the 5a40796 AI docs alignment merge baseline

Test-only approval commit after the 5a40796 main merge (sw-test-regression-
baseline section 9); no protected path changes, no Story change.
- approvedMainCommit 955581c -> 5a40796.
- public-api.approved.json kept: the public .d.ts files are byte-identical.
- docs/sw/ai-docs-alignment-merge-2026-10-22.md: change and verification.

docs/sw/ai-docs-alignment-merge-2026-10-22.md

@@ -0,0 +1,53 @@
+# AI 문서 정합성 P1~P3·R1~R5 main 병합 검증 (2026-10-22)
+
+main `d71db6c` 기준 AI 문서 정합성 점검(판정 PARTIAL)에서 찾은 필수 P1~P3와 권장 R1~R5를 문서만으로 맞추고 main에 반영한 기록입니다. 컴포넌트 소스·CSS·Story·Public API는 바꾸지 않았습니다.
+
+## 1. 병합
+
+| 항목 | 값 |
+|---|---|
+| P1~P3 Commit | `d03cc91` docs(sw): align viewer AI docs with open button, documents list and hover |
+| R1~R5 Commit | `e267b1b` docs(ai): apply recommended doc alignment R1-R5 |
+| main 병합 | `d71db6c` → `5a40796` (no-ff, `docs/sw-viewer-ai-docs-p1-p3`) |
+| 승인 기준 Commit | 이 보고서와 같은 테스트 전용 Commit (`approvedMainCommit` `955581c` → `5a40796`) |
+
+## 2. 수정 내용
+
+| # | 파일 | 내용 |
+|---|---|---|
+| P1 | `packages/sw/ai/AI_USAGE.md` §0.4 | 뷰어 Hover `#266651` 면 제거 → 배경 변경 없이 글자·아이콘만 `#FFC600` |
+| P2 | `packages/sw/ai/AI_USAGE.md` §0.2 | 파일 열기 = 로고 오른쪽 `onDocumentOpen` 버튼, 샘플 = `documents` 목록(`groups` 항목 아님) |
+| P3 | `packages/sw/ai/COMPONENT_CATALOG.md` §9 | `SWViewerHeader` 배치·Open 위치(로고 옆, 목록 안 아님), `logoMenu` 호환용 표시 |
+| R1 | `packages/sw/ai/COMPONENT_CATALOG.md` §9 | `SWViewerHeaderButton`: `custom` 안 32 × 40, `trailing` 띠 안 32 × 48(테두리·선 없음) |
+| R2 | `packages/sw/ai/COMPOSITION_PATTERNS.md` §7 | 파일 열기 아이콘 = 아이콘 자체 검정 외곽선만, 별도 테두리·배경 면 없음 |
+| R3 | `packages/sw/ai/VIEWER.md` §2 | 아이콘 영역 16 × 16, 버튼 padding `0 12px 0 24px` |
+| R4 | `docs/ai/MAINTAINING.md` §1 | SW `ai/`: `FOOTER.md` 포함 Markdown 8개, 예제 A~J 10개(G·I 포함)와 보조 파일 |
+| R5 | `docs/ai/AI_GUIDE.md` | center-graphic 진입점 `/reference`(참고 데모)·`/style.css` — `npm run sync:ai-docs`로 4개 패키지 사본 반영 |
+
+대조한 코드: `SWViewerHeader.tsx`(Open 버튼·문서 목록 `showOpen={false}`·`logoMenu` 주석), `sw-viewer.css`(Hover 글자색, `__open` padding, `__open-icon` 16px, `data-icon-only="always"` 32 × 40, `trailing` 띠 stretch), `packages/center-graphic/package.json` exports.
+
+`sync:ai-docs`가 LF checkout인 `packages/sw/ai/` 사본에 CRLF를 쓰므로 두 사본의 줄바꿈을 LF로 되돌린 뒤 Commit했습니다(내용 동일, `check:ai-docs`는 줄바꿈 무시).
+
+## 3. 승인 기준 갱신 (`sw-test-regression-baseline-2026-10-20.md` §9)
+
+- `approvedMainCommit`: `955581c` → `5a40796`(테스트 전용 Commit, 보호 경로 변경 없음).
+- `public-api.approved.json` 유지: 공개 `.d.ts`가 승인 빌드와 바이트 동일. Story 추가·제거·이동·태그 변경이 없어 다른 승인 목록은 바꾸지 않았습니다.
+
+## 4. 검증 결과 (Node 22.23.2, `npm run build-storybook` 후, 증거는 저장소 밖 임시 폴더)
+
+| 검사 | 결과 |
+|---|---|
+| `npm run build-storybook` | 성공 |
+| home-menu-integration | 23/23 PASS |
+| overview / overview overlays | 53/53, 20/20 PASS |
+| storybook-unused-removal (Source Guard) | 94/94 PASS |
+| Public API Guard | 7/7 PASS |
+| `check:ai-docs` · `ai-docs.check.mjs` | PASS · 46/46 PASS |
+| 공유 사본(AI_GUIDE·AGENTS_SNIPPET × 4) | 원본과 동일(줄바꿈 제외) |
+
+검사 실행 시 `dist/build-info.json`의 `dirty`는 `true`였습니다. 원인은 아직 Commit 전인 이 테스트 전용 변경(`storybook-inventory.mjs`)뿐이며 제품 소스는 `5a40796`과 같습니다.
+
+## 5. 재실행하지 않은 항목
+
+- 문서만 바뀌어 Typecheck, Viewer·Header·Footer·Popup 기능 테스트, 소비 프로젝트 빌드는 다시 실행하지 않았습니다.
+- 남은 문서 항목(이번 범위 밖): `packages/sw/ai/AI_USAGE.md` 문서 표의 examples 설명이 A~F·H만 적고 G·I·J를 적지 않습니다.

packages/sw/tests/storybook-inventory.mjs

@@ -73,7 +73,9 @@ export const integratedChangedFiles = [
 // and button-height token, 0840d76; CSS and docs only, no Story change, public-api.approved.json kept).
 // -> 955581c (2026-10-21, Merge fix/sw-viewer-button-height-34: user-approved restore of the viewer button-height
 // token to 34px, 51d0369; CSS and docs only, no Story change, public-api.approved.json kept).
-export const approvedMainCommit = '955581c6c48a947a49896a0cdd824b4106c61b97'
+// -> 5a40796 (2026-10-22, Merge docs/sw-viewer-ai-docs-p1-p3: user-approved AI doc alignment P1-P3 d03cc91 and
+// R1-R5 e267b1b; docs only, no source / CSS / Story change, public-api.approved.json kept).
+export const approvedMainCommit = '5a40796b7ebcae55cea74437e4aa2e88904615e9'
 // 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.