dd-config

dding-dong 설정 관리

사용법

$ARGUMENTS 를 파싱하여 동작을 결정합니다:

show (기본)

현재 설정을 한국어로 표시합니다. 스코프별 설정 출처도 함께 안내합니다.

node "${CLAUDE_PLUGIN_ROOT}/scripts/check-config.mjs" --cwd "$(pwd)"

결과를 파싱하여 사용자에게 한국어로 표시합니다. _meta와 messages 내부 필드는 표시에서 제외합니다:

현재 설정 (적용 중인 스코프: [스코프 정보])
- 전역 설정: [경로] ([존재/없음])
- 프로젝트 설정: [경로] ([존재/없음])
- 내 설정 (Local): [경로] ([존재/없음])

| 설정 | 값 |
|------|-----|
| 활성화 | config.enabled (예/아니오) |
| 언어 | config.language |
| 사운드 | config.sound.enabled (켜짐/꺼짐) |
| 사운드 팩 | config.sound.pack |
| 볼륨 | config.sound.volume |
| OS 알림 | config.notification.enabled (켜짐/꺼짐) |
| 야간 모드 | config.quiet_hours.enabled (꺼짐 / 켜짐 HH:MM~HH:MM) |
| 쿨다운 | config.cooldown_seconds초 |

이벤트 설정:
| 이벤트 | 사운드 | 알림 |
|--------|:------:|:----:|
| task.complete | ✓/- | ✓/- |
| task.error | ✓/- | ✓/- |
| input.required | ✓/- | ✓/- |
| session.start | ✓/- | ✓/- |
| session.end | ✓/- | ✓/- |

각 이벤트의 ✓/- 는 config.sound.events와 config.notification.events에서 해당 이벤트 키의 true/false를 확인합니다.

get [key]

단일 설정 키의 현재 값을 조회합니다. dot notation 지원 (예: sound.volume, quiet_hours.enabled, notification.events.task.complete).

$ARGUMENTS에서 key를 추출하여 ${KEY}로 치환합니다.

node "${CLAUDE_PLUGIN_ROOT}/skills/dd-config/scripts/config-get.mjs" '${KEY}' --cwd "$(pwd)"

• 성공 시: "[key] = [value]"
• 키 없음 시: "설정 키를 찾을 수 없습니다: [key]"

set [key] [value]

중첩 키를 dot notation으로 지원합니다 (예: sound.volume 0.5, notification.events.session.start true).

--scope 옵션으로 대상 스코프를 지정할 수 있습니다:

• --scope global -- 전역 설정에 반영 (기본값)
• --scope project -- 프로젝트 설정에 반영 (팀 공유, 커밋됨)
• --scope local -- 내 설정에 반영 (개인 오버라이드, 커밋 제외)

프로젝트/로컬 스코프 지정 시 해당 파일에 오버라이드 키만 (diff-only) 저장합니다.

$ARGUMENTS에서 key, value, --scope 플래그를 추출하여 ${KEY}, ${VALUE}, ${SCOPE}로 치환합니다. ${SCOPE}가 없으면 global을 기본값으로 사용합니다.

node "${CLAUDE_PLUGIN_ROOT}/skills/dd-config/scripts/config-set.mjs" '${KEY}' '${VALUE}' --scope '${SCOPE}' --cwd "$(pwd)"

• 성공 시: "[key]를 [oldValue] → [newValue]로 변경했습니다. (스코프: [scope])"
• 이전 값과 동일 시: "[key]는 이미 [newValue]입니다."
• 유효하지 않은 키 (invalid_key 에러): "알 수 없는 설정 키: [key]. 사용 가능한 키: [validKeys 목록]"
• 그룹 키 (object_key 에러): "[key]는 개별 설정이 아닌 그룹입니다. 하위 키를 지정하세요 (예: [key].enabled)."
• 프로젝트 루트 없음 (exit 1): "프로젝트 루트를 찾을 수 없습니다. --scope global을 사용하거나 프로젝트 디렉토리에서 실행하세요."

reset

설정을 기본값으로 복원합니다.

AskUserQuestion으로 대상 스코프를 확인합니다: "어떤 설정을 초기화하시겠습니까?"

1. "전역 설정 초기화" -- ~/.config/dding-dong/config.json 삭제
2. "프로젝트 설정 초기화" -- .dding-dong/config.json 삭제 (프로젝트 설정이 존재하는 경우만 표시)
3. "내 설정 초기화" -- .dding-dong/config.local.json 삭제 (내 설정이 존재하는 경우만 표시)
4. "취소"

사용자 확인 후, 삭제 전에 백업을 생성합니다:

node --input-type=module -e "
import { backupConfig } from '${CLAUDE_PLUGIN_ROOT}/scripts/core/config.mjs';
const filePath = process.argv[1];
const result = backupConfig(filePath);
if (result) console.log('백업 생성:', result);
else console.log('백업 대상 파일 없음');
" '${TARGET_FILE_PATH}'

백업 생성 후 해당 설정 파일을 삭제합니다. 백업 실패 시에도 삭제는 진행합니다.

---

관련 스킬

• 사운드 팩 관리 → /dding-dong:dd-sounds
• 알림 문제 진단 → /dding-dong:dd-doctor
• 전체 기능 안내 → /dding-dong:dd-help