# VSCodium (codium) 설치 스크립트 및 문서 추가 계획 (INSTALL-CODIUM-IMP-PLAN)

## 1. 개요
Visual Studio Code(VS Code)의 오픈소스 코드베이스에서 마이크로소프트의 원격 측정(Telemetry)/트래킹 및 불필요한 독점 요소를 완전히 제거하고 **개발에 꼭 필요한 순수 핵심 기능만 남긴 경량 오픈소스 바이너리 에디터 `VSCodium (codium)`**의 크로스 플랫폼 자동 설치 스크립트(`install-codium.sh`, `install-codium.ps1`)를 제작하고 `README.md` 및 `NECESSARY.md` 문서에 반영합니다.

```mermaid
flowchart TD
    Start([install-codium 실행]) --> OSCheck{운영체제 감지}
    OSCheck -- macOS --> BrewInstall["Homebrew Cask 설치<br/>(brew install --cask vscodium)<br/>또는 GitHub Release 폴백"]
    OSCheck -- Linux --> LinuxRepo["공식 패키지 저장소 등록 및 설치<br/>APT (Debian/Ubuntu) / DNF·Zypper (RHEL/SUSE) /<br/>Pacman·AUR (Arch) / GitHub Release tarball 폴백"]
    OSCheck -- Windows --> WinInstall["winget install --id VSCodium.VSCodium<br/>또는 GitHub Releases UserSetup.exe<br/>무인 설치(/VERYSILENT) 및 PATH 연결"]
    BrewInstall & LinuxRepo & WinInstall --> CLI["codium CLI 명령어 및 PATH 검증"]
    CLI --> Done([설치 완료])
```

## 2. 작업 단계 및 체크리스트

### 단계 1: 실행 계획 수립
- [x] 작업 계획서(`VIBE-WORK/261104/INSTALL-CODIUM-IMP-PLAN.md`) 작성

### 단계 2: Unix / macOS용 `install-codium.sh` 구현
- [x] macOS: Homebrew를 통한 `brew install --cask vscodium` 설치 및 `/Applications/VSCodium.app/Contents/Resources/app/bin/codium`을 `~/.local/bin/codium`에 심볼릭 링크 연결
- [x] Linux (Debian/Ubuntu): https://vscodium.com 공식 가이드에 따라 GPG 키(`/usr/share/keyrings/vscodium-archive-keyring.gpg`) 및 APT 저장소(`https://download.vscodium.com/debs`) 등록 후 `sudo apt-get install -y codium`
- [x] Linux (Fedora/RHEL/Rocky/openSUSE): 공식 RPM 저장소(`https://download.vscodium.com/rpms/`) 및 GPG 키 등록 후 `dnf` / `zypper` 설치
- [x] Linux (Arch): `yay` / `paru` 등 AUR 헬퍼 또는 Snap/Flatpak/GitHub Releases(`VSCodium-linux-<arch>-<ver>.tar.gz`) 3단계 방어 폴백 지원
- [x] 실행 권한 부여 및 `bash -n` 문법 검증

### 단계 3: Windows용 `install-codium.ps1` 구현
- [x] 1차: 공식 권장 방식인 `winget install -e --id VSCodium.VSCodium` 설치 시도
- [x] 2차(폴백): `winget`이 없거나 실패할 경우 GitHub Releases API(`VSCodium/vscodium`)에서 아키텍처(`x64`/`arm64`)에 맞는 최신 `VSCodiumUserSetup-<arch>-<version>.exe` 에셋을 다운로드하여 무인 설치(`/VERYSILENT /MERGETASKS=!runcode,addcontextmenufiles,addcontextmenufolders,associatewithfiles,addtopath`) 수행 (Fallback 버전 `1.96.2.24355` 내장)
- [x] `codium.cmd` / `codium` 경로 확인 및 현재 세션/사용자 `PATH` 자동 등록

### 단계 4: `README.md` 및 `NECESSARY.md` 문서 업데이트
- [x] `README.md`의 `3. 개발 유틸리티 & 웹 터미널` 섹션에 `VSCodium (codium)` 추가 (VS Code에서 파생되었으나 불필요한 트래킹/독점 요소를 덜어내고 최소한의 핵심 기능만 담은 순수 오픈소스 코드 에디터임을 강조)
- [x] `NECESSARY.md`의 `3. 개발 유틸리티` 섹션 및 설치 가이드, 핵심 사용법에 `VSCodium (codium)` 추가

### 단계 5: 완료 보고서 작성 및 Graphify 갱신 / Git 푸시
- [x] 완료 보고서(`VIBE-WORK/261104/INSTALL-CODIUM-PHASE01.md`) 작성
- [x] `uv tool run --from graphifyy graphify update .` 실행
- [x] Git commit 및 push