SnapPoint: Dev Machine를 위한 Hard Reset

I’m happy to translate the article for you, but I’ll need the text you’d like translated. Could you please paste the content of the article (or the portion you want translated) here? I’ll keep the source line unchanged and preserve all formatting as requested.

대부분의 개발자 머신은 깨끗하지 않다. 겉만 깨끗해 보일 뿐이다.

어느 순간, 모든 개발자 노트북은 쓰레기장이 된다. 블로그 글을 따라 하다 보니 도구를 설치하고, 주말에 프레임워크를 써보고, 직장을 옮기면서 새로운 스택을 물려받는다. 뭔가를 삭제하지만 절반만 지우고, 바이너리는 남아있고, 설정 파일은 홈 디렉터리 어딘가에 파묻힌다. 캐시는 조용히 배경에서 늘어난다.

아무것도 완전히 망가진 건 아니지만, 뭔가 맞지 않는다.

터미널이 이상하게 행동한다. 어떤 명령이 내가 설치하지 않은 버전을 가리킨다. 다음을 실행한다:

which python

그리고 그 결과가 마음에 들지 않는다. Node가 여러 곳에 존재하고 오늘 어느 것이 우선인지 확신이 서지 않는다. 나중에 정리하겠다고 스스로에게 다짐한다.

하지만 그 ‘나중’은 오지 않는다.

SnapPoint는 바로 그 순간을 위해 만들어졌다 – 시스템이 어긋났다는 것을 깨달지만, 뭔가를 부수지 않고 스스로 고칠 자신이 없을 때.

SnapPoint가 실제로 하는 일

SnapPoint는 다른 패키지 매니저가 아니다. Homebrew, NPM, Pip, NVM, Cargo 등 이미 사용 중인 도구들을 대체하려 하지 않는다.

그것들은 위에 존재한다.

SnapPoint는 시스템 감사 도구이자 패키지‑매니저 매니저이다. 역할은 머신에 무엇이 설치돼 있는지, 어디서 왔는지, 아직도 그곳에 있어야 하는지를 파악하는 것이다.

• 무작정 삭제하는 대신, SnapPoint는 먼저 시스템의 정신 모델을 만든다.
• 전역 바이너리를 스캔하고, 출처를 추적하며, PATH를 확인하고, 충돌, 고아, 깨진 링크, 남은 파일을 찾아낸다.
• 그 후에야 행동을 취하도록 허용한다.

이 차이가 중요하다. 이제 추측이 아니라 선택을 할 수 있다.

우리가 모두 정상이라고 가장하는 혼란

현대 개발 환경은 여러 층으로 이루어진다:

1. OS‑레벨 도구
2. 언어‑레벨 도구
3. 프로젝트‑레벨 도구
4. 그 도구들을 감싸는 래퍼

각 층은 자체적으로 정리를 하지만, 서로 조율하지는 않는다.

시간이 지나면 다음과 같은 흔한 문제가 생긴다:

• 고스트 바이너리가 /usr/local/bin 혹은 /opt/homebrew/bin에 남아 있어 어느 매니저도 더 이상 관리하지 않는다.
• 동일 도구의 여러 버전이 PATH에서 우선순위를 놓고 경쟁한다.
• 수 기가량 사용하지 않은 도구들의 캐시 파일이 기가바이트 단위로 쌓인다.
• 고아 의존성이 남아 있다. 이미 제거한 무언가를 위해 설치된 경우다.

이것은 예외 상황이 아니다. 1~2년이 지난 대부분의 개발자 머신이 기본적으로 처한 상태다.

SnapPoint는 이러한 모든 상황을 드러내도록 설계되었다.

사냥: 삭제 전에 이해하기

SnapPoint의 첫 번째 단계는 **사냥 (the Hunt)**이라 불린다.

• 시스템을 스캔하고 모든 전역 바이너리, 모든 PATH 항목, 인식 가능한 모든 매니저의 목록을 만든다.
• 각 도구마다 SnapPoint는 간단한 질문에 답하려 한다: “이게 어디서 왔지?”
  • Homebrew, NVM, Pip, Cargo 등으로 설치된 건가?
  • 아니면 기록 없이 수동으로 놓여진 건가?

그 출처 이야기가 핵심이다. 바이너리가 어디서 왔는지 알면 어떻게 할지 결정할 수 있다. 이 맥락 없이 정리는 단순히 추측에 불과하다. SnapPoint는 그 추측을 가시성으로 바꾼다.

고스트와 고아

SnapPoint가 제공하는 가장 유용한 출력 중 하나는 고스트라 부르는 것이다.

• 고스트 – 시스템에 존재하지만 이제는 어떤 패키지 매니저도 관리하지 않는 바이너리. 어느 버전 매니저도 이들을 추적하지 않는다.

Source: …

Ghosts는 종종 무해합니다—하지만 그렇지 않을 때도 있습니다. 그들은 다음과 같은 일을 할 수 있습니다:

• 예상했던 명령을 무시합니다.
• PATH 해석을 혼란스럽게 합니다.
• 다른 버전을 기대하는 스크립트를 깨뜨립니다.

어떤 도구도 이를 소유하고 있지 않기 때문에, 절대 삭제되지 않습니다. SnapPoint는 이러한 ghost들을 찾아 명확히 표시하고 자동으로 삭제하지는 않습니다. 어떤 것이 의심스러운지 보여주고 이유를 설명합니다.

동일하게 orphans(고아)도 마찬가지입니다:

• 의존성으로 설치됐지만 한 번도 정리되지 않은 패키지.
• 로컬 프로젝트가 이미 관리하고 있음에도 중복되는 전역 도구.
• 어디에도 연결되지 않은 깨진 심볼릭 링크.

이것이 시스템을 서서히 악화시키는 요인입니다. SnapPoint는 이를 밝히는 빛이 됩니다.

PATH와 싸우지 않고 정렬하기

PATH 문제는 로컬 개발에서 가장 답답한 부분 중 하나입니다.

1. 도구를 설치하면—작동합니다.
2. 나중에 다른 위치에 또 다른 버전을 설치하면—잘못된 것이 실행됩니다.
3. 쉘 설정에 export를 추가하고 잘 작동하기를 기대합니다.

SnapPoint는 접근 방식을 다르게 합니다.

• 동일한 도구의 여러 버전을 감지하면 모두를 표시하고, 위치, 설치자, 현재 활성 버전을 알려줍니다.
• 그런 다음 진실의 원천을 선택하도록 합니다.
• PATH를 손수 계속 수정하는 대신, 명시적인 결정을 내립니다: 이 버전이 승리하고, 나머지는 강등되거나 제거됩니다.

이 정렬만으로도 기계 수명 동안 디버깅에 소요되는 시간을 몇 시간씩 절감할 수 있습니다.

실제로 정리하는 클린업

제거는 쉽습니다. 정리는 쉽지 않죠.

대부분의 제거 명령은 바이너리나 패키지 참조만 삭제합니다. 설정 폴더, 상태 파일, 캐시 등은 남겨 둡니다. 시간이 지나면 이러한 잔여물이 나중에 재설치할 때 이상 동작을 일으킵니다.

SnapPoint는 클린업 레시피 개념을 포함합니다.

• 레시피는 도구를 완전히 제거하는 방법을 설명합니다—실행 파일뿐 아니라 .config, .cache 및 기타 알려진 위치에 있는 관련 폴더까지.
• 이 지식은 공유되고 커뮤니티 기반입니다. 모든 도구가 어디에 쓰레기를 남기는지 아는 사람은 없으며, 그래서 SnapPoint는 오픈 소스입니다.

도구를 재설치했는데도 이전 설정이 남아 있는 것을 본 적이 있다면, 이것이 이유입니다. SnapPoint는 이를 제대로 고치려 합니다.

Doctor 모드

몇몇 문제는 미묘합니다:

• 더 이상 존재하지 않는 버전을 가리키는 깨진 심볼릭 링크.
• 프로젝트 로컬 패키지를 가리는 전역 패키지.
• 기술적으로는 설치돼 있지만 사용할 수 없는 도구.

SnapPoint는 이러한 문제를 찾아 명확히 보고하는 doctor mode를 포함합니다—암호 같은 경고가 아니라 실행 가능한 인사이트로 제공합니다.

시스템 프로필 및 스냅파일

One of the longer‑term ideas behind SnapPoint is system profiles.

Instead of treating your machine setup as a one‑time thing, SnapPoint lets you export:

• Your tools
• Their versions
• Their sources
• Your alignment choices

These become a Snapfile (or snap.json).

You can use it to:

• Recreate your environment on a new machine
• Share it with teammates
• Publish it as a curated setup

Think less “dotfiles magic” and more explicit system DNA. This makes onboarding faster and personal setups portable.

SnapPoint는 누구를 위한 것인가

SnapPoint는 도구에 신경을 쓰지만 계속 감시해야 하는 데 지친 개발자를 위한 것입니다.

기계에 이해를 원하고, 싸우고 싶지는 않은 사람들을 위한 것입니다.

• 시스템을 정리하는 것이 어떤 것이 깨질지 몰라 두려웠다면, SnapPoint가 당신을 위한 것입니다.
• 노트북이 평소보다 느리거나 이상하게 느껴진다면, SnapPoint가 당신을 위한 것입니다.
• 미신 대신 확신을 원한다면, SnapPoint가 당신을 위한 것입니다.

아직 초기 단계입니다. 로드맵에는 다음이 포함됩니다:

• Go와 Bubble Tea로 만든 전체 TUI 대시보드
• 더 똑똑한 정리 기능
• 소셜 시스템 프로필

하지만 핵심 아이디어는 이미 탄탄합니다.

SnapPoint는 완벽한 기계를 약속하지 않습니다.
명확성을 약속합니다.

그리고 그 명확성을 얻으면, 나머지를 고치는 것이 훨씬 쉬워집니다.