devsync doctor

형식

devsync doctor

설명

devsync doctor는 Devsync 환경에 대한 일련의 상태 검사를 실행하고 문제를 보고해요. push, pull, 또는 복호화가 예상대로 작동하지 않을 때 원인을 가장 빠르게 파악할 수 있는 방법이에요.

새 기기에 Devsync를 설정한 직후, age 키를 교체한 후, 또는 명령 실행 중 예상치 못한 오류가 발생했을 때 실행해 보세요.

검사 항목

검사	설명
저장소 디렉터리	~/.config/devsync/sync/가 존재하고 유효한 git 저장소인지 확인해요.
manifest 유효성	manifest.json을 파싱해서 스키마 오류나 구문 오류를 보고해요.
Age identity	settings.json에 설정된 age identity 경로의 파일이 읽기 가능하고 키를 불러올 수 있는지 확인해요.
추적 경로 존재 여부	manifest.json에 등록된 각 경로가 로컬 파일 시스템에 실제로 존재하는지 확인해요.

하나라도 실패하면 종료 코드 1로 종료해요. 모든 검사는 항상 실행되므로 한 번의 실행으로 전체 진단 결과를 확인할 수 있어요.

옵션

플래그	설명
--verbose	각 검사의 상세 진단 정보를 표시해요.

예시

# 모든 상태 검사 실행
devsync doctor

# 각 검사의 상세 내용 확인
devsync doctor --verbose

출력 예시

✓ 저장소 디렉터리가 존재하고 유효한 git 저장소예요
✓ manifest.json이 유효해요
✗ Age identity: /home/user/.secrets/age-identity.txt 파일을 찾을 수 없어요
✓ 추적 중인 로컬 경로: 12/13개 존재
  ✗ ~/.config/missing-tool/config.toml — 파일 없음

참고

참고

추적 경로 존재 여부 검사에서 누락된 경로는 치명적 오류가 아닌 경고로 표시돼요. 특정 도구가 설치되지 않은 기기에서 해당 경로가 없는 건 정상이에요. 목록을 검토하고 현재 기기에 해당하지 않는 경로는 untrack으로 제거하는 것을 고려해 보세요.

참고

doctor는 원격 서버에 접속하거나 파일 복호화를 시도하지 않아요. 설정 파일을 읽고 파일 시스템 상태를 확인하는 것이 전부예요.