dd-setup

dding-dong 설정 마법사

사용자의 환경을 확인하고 dding-dong 알림 플러그인을 설정합니다.

플래그 파싱

$ARGUMENTS에서 플래그를 확인합니다:

• --help: 아래 사용법을 출력하고 종료합니다.

  dding-dong 설정 마법사
  
  사용법: /dding-dong:dd-setup [옵션]
  
  옵션:
    --scope global|project|local  설치 범위 지정 (2단계 건너뜀)
    --force                       기존 설정 무시, 전체 재설정
    --help                        이 도움말 표시
  

• --scope <값>: global, project, local 중 하나. 지정 시 2단계(스코프 선택)를 건너뛰고 해당 스코프로 진행합니다.

• --force: Pre-Setup Check를 건너뛰고 바로 "전체 재설정" 모드로 진행합니다.

실행 순서

1단계: Pre-Setup Check + 환경 감지

아래 명령어를 실행하여 환경을 감지합니다:

node "${CLAUDE_PLUGIN_ROOT}/scripts/setup-wizard.mjs" detect --cwd "$(pwd)"

결과 JSON을 파싱하여 사용자에게 한국어로 안내합니다:

• "플랫폼: [macOS/Linux/WSL] 감지됨"
• "사운드 플레이어: [이름] 사용 가능" 또는 "사운드 플레이어를 찾을 수 없습니다"
• "알림 도구: [이름] 사용 가능" 또는 "알림 도구를 찾을 수 없습니다"

Graceful Degradation:

• 사운드 플레이어가 없으면: "사운드 재생기를 찾을 수 없습니다." 안내 (정보 메시지만, 플래그 설정은 3단계에서 처리)
• 알림 도구가 없으면: "OS 알림 도구를 찾을 수 없습니다." 안내 (정보 메시지만, 플래그 설정은 3단계에서 처리)
• 둘 다 없으면: "터미널 벨을 사용합니다." 안내 후 sound.enabled: false, notification.enabled: false로 설정하고 3단계를 건너뜁니다
• 감지 자체가 실패하면 기본값으로 조용히 계속 진행

WSL에서 wsl-notify-send가 없으면:

• "wsl-notify-send 설치를 권장합니다: https://github.com/stuartleeks/wsl-notify-send"

Pre-Setup Check (기존 설정 감지):

--force 플래그가 있으면 이 단계를 건너뛰고 "전체 재설정" 모드로 2단계에 진행합니다.

existingConfig 필드를 확인하여:

• 기존 설정이 있으면 (global.exists, project.exists, projectLocal.exists 중 하나라도 true):

  기존 dding-dong 설정이 발견되었습니다.
  - 전역 설정: ~/.config/dding-dong/config.json [존재/없음]
  - 프로젝트 설정: .dding-dong/config.json [존재/없음]
  - 내 설정: .dding-dong/config.local.json [존재/없음]
  

  구버전 업그레이드 감지:

  기존 설정이 발견된 경우, detect 결과의 setupVersion과 pluginVersion 필드를 비교합니다:

  • setupVersion이 null → "이전 버전에서 업그레이드된 설정이 감지되었습니다. 설정을 업데이트하면 최신 기능을 활용할 수 있습니다."
  • setupVersion과 pluginVersion이 다름 → "dding-dong이 v{setupVersion}에서 v{pluginVersion}으로 업데이트되었습니다. 설정을 업데이트하여 새 기능을 반영할 수 있습니다."
  • 버전이 같음 → 별도 안내 없음

  이 안내는 정보 제공만 하며, 이후 AskUserQuestion 흐름을 변경하지 않습니다.