cli v0.6.0: 설치/업그레이드 시 Claude Code 전역 슬래시 명령 /yakcloud 자동 생성(.claude/commands/yakcloud.md); install.sh·upgrade 가 fetch·최신화

.claude/commands/yakcloud.md

@@ -0,0 +1,43 @@
+---
+description: YakCloud 배포 CLI를 Claude Code에서 구동 — 스캐폴딩·배포·데이터소스·도메인 (/yakcloud <args>)
+argument-hint: project init <name> | project deploy | datasource ls | domain <fqdn> | info | check
+allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
+---
+
+사용자가 `/yakcloud $ARGUMENTS` 로 호출했다. 너는 `yakcloud` CLI(단일 진실원천)를 **현재 작업 디렉터리**에서
+구동하는 드라이버다. 터미널이 아니라 Claude Code 안이므로, TTY가 필요한 대화형 흐름은 네가 값을 모아
+**비대화형으로 대신** 실행한다.
+
+## 0) 준비 (매 호출 첫 단계)
+- `command -v yakcloud` 확인. 없으면 설치:
+  `curl -fsSL https://gitea.yakenator.io/yakenator/yakcloud-starter/raw/branch/main/install.sh | sh`
+  이후에도 PATH에 없으면 `$HOME/.local/bin/yakcloud` 절대경로로 실행.
+- `알 수 없는 명령`/구버전 신호가 보이면 `yakcloud upgrade` 로 최신화 후 재시도.
+
+## 1) 디스패치 — `$ARGUMENTS`
+- **비어 있거나 `help`** → `yakcloud help` 실행 결과 + 한 줄 사용 요약.
+- **`project init [name]`** → §2 스캐폴딩(마법사 대체).
+- **`login`** → 비밀 입력이라 여기서 실행하지 말고, 터미널에서 `yakcloud login` 하라고 한 줄 안내.
+  (사용자가 값을 직접 주면 `YAKCLOUD_URL=… YAKCLOUD_TOKEN=… GITEA_USER=… GITEA_TOKEN=… yakcloud config` 로 저장하되 **값은 화면에 출력 금지**.)
+- **그 외 전부**(`project deploy|info|check|update`, `datasource ls`, `domain`, `scale`, `set`, `env`,
+  `source`, `bind`, `unbind`, `config`, `upgrade`) → `yakcloud $ARGUMENTS` 를 실행하고 **출력을 그대로** 보여준 뒤,
+  필요할 때만 한 줄로 해석. 배포/삭제성(`deploy`·`source rm`·`unbind`·`domain`)은 실행 전 무엇을 하는지 한 줄 알리고 진행.
+
+## 2) `project init` — 마법사 대체 (핵심)
+터미널 마법사는 TTY가 없으면 안 뜬다. 네가 대신한다:
+1. `yakcloud project init <name> -y` 로 **비대화형 스캐폴딩**(기본 매니페스트 생성; `bin/`·`install.sh` 잔재 없음).
+2. `$ARGUMENTS`/대화 맥락에 이미 있는 값은 **재질문 금지**. 부족한 핵심값만 `AskUserQuestion` 으로 모은다:
+   대상 클러스터, 앱 포트, 노출 경로(기본 `/`), CPU/메모리, 필요한 데이터소스(있으면), 도메인(있으면).
+3. 모은 값을 CLI로 반영:
+   - `yakcloud set <wl> --port … --cpu … --mem … --path …`
+   - 소스: `yakcloud source add <name> <type> [plan]` + `yakcloud bind <wl> <name> <alias>`
+   - 도메인: `yakcloud domain <fqdn> <wl>`
+   - 이용 가능한 클러스터 소스를 먼저 보고 싶으면 `yakcloud datasource ls`.
+4. 자격 미설정이면(`yakcloud config` 로 확인) 터미널 `yakcloud login` 안내.
+5. 다음 단계(개발 → `yakcloud project deploy`) 를 요약.
+
+## 규약
+- 전역 명령이지만 **대상은 현재 프로젝트**(현지 `yakcloud.yaml`). ctl 계열(`set`/`env`/`source`/`bind`/`domain`/`info`)은
+  프로젝트 폴더에서만 동작 — 아니면 먼저 `yakcloud project init` 안내. `datasource ls` 는 클러스터만 있으면 조회 가능.
+- **자격/비밀 화면 출력 금지.** 배포토큰(`yakd_…`)·Gitea 토큰은 CLI의 OS 키체인 저장에 위임.
+- 실패 시 종료코드·stderr 를 그대로 + 원인이 자명하면 한 줄 + 다음 행동 제시.