CLI 재구성: yakcloud project init/deploy/info/check + 설정동사(domain/scale/set/env/source/bind) + 자동 버전업 + yakcloud_ctl 엔진 + deploy CLI env 지원

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -1,47 +1,54 @@
 # yakcloud-starter — YakCloud 프로젝트 기반 + CLI + Claude Code 스킬
 
-빈 폴더에서 **한 명령으로 새 프로젝트를 초기화**하고, **태그 push로 YakCloud에 자동 배포**하기 위한 기반.
-프레임워크 중립 스타터 앱 + CI + 매니페스트 + **`yakcloud` CLI** + **Claude Code 스킬**(`.claude/skills/yakcloud-deploy/`)이 들어 있다.
+빈 폴더에서 **한 명령으로 프로젝트를 초기화**하고, **태그 push로 자동 배포**하며, **배포 환경을 CLI로 상세 설정**한다.
+프레임워크 중립 스타터 앱 + CI + 매니페스트 + **`yakcloud` CLI** + **Claude Code 스킬**(`.claude/skills/yakcloud-deploy/`) 포함.
 
 ## CLI 설치 (1회)
 ```sh
 curl -fsSL https://gitea.yakenator.io/yakenator/yakcloud-starter/raw/branch/main/install.sh | sh
-# PATH: export PATH="$HOME/.local/bin:$PATH"
+export PATH="$HOME/.local/bin:$PATH"
 ```
 
 ## 빈 폴더 → 배포까지
 ```sh
-yakcloud init my-app        # 빈 폴더에 스타터+CI+매니페스트+Claude 스킬 스캐폴딩
+yakcloud project init my-app     # 스타터+CI+매니페스트+Claude 스킬 스캐폴딩
 cd my-app
-# (앱 개발 — Claude Code 로: "yakcloud 로 배포 붙여줘" / 앱 코드 작성)
-# yakcloud.yaml 의 cluster / image(<GITEA_USER>) 수정, 필요하면 requires·binds 추가
-yakcloud deploy v0.1.0      # 커밋 + 태그 push → Gitea Actions 자동 배포
+# (앱 개발 — Claude Code: "yakcloud 로 배포 붙여줘")
+yakcloud project info            # 프로젝트 개괄(매니페스트 + 라이브 상태)
+yakcloud project deploy          # 커밋 + 태그 push (버전 미지정 시 자동 버전업) → 자동 배포
 ```
-> **Claude Code 흐름**: 빈 폴더에서 Claude Code를 열고 "프로젝트 초기화해줘" → Claude가 `yakcloud init` 실행 →
-> 개발 → "yakcloud에 배포해줘" → Claude가 `yakcloud deploy` 실행. (CLI가 없으면 스킬의 수동 절차로 진행)
+> **Claude Code 흐름**: 빈 폴더에서 "프로젝트 초기화해줘" → `yakcloud project init` → 개발 → "yakcloud에 배포해줘" → `yakcloud project deploy`.
+
+## 명령
+```
+project init [name]          빈 폴더 스캐폴딩
+project deploy [vX.Y.Z]      커밋+태그 push → 자동 배포 (버전 생략 시 최신 태그 patch+1 자동 버전업)
+project info                 프로젝트 개괄(매니페스트 + 라이브 상태)
+project check                dry-run(직접 API 계획만)
+─ 배포환경 설정(앱별): 매니페스트 수정 + 배포중이면 재빌드 없이 라이브 반영 ─
+domain <fqdn> [wl]           도메인 등록 + 워크로드 할당(관리형=즉시 활성)
+scale <wl> <n>               replicas
+set <wl> --image/--port/--health/--cpu/--mem/--path/--rewrite
+env <wl> KEY=VAL … [--secret KEY] [--unset KEY]
+source add <name> <type> [plan] | source rm <name>
+bind <wl> <source> <alias>   | unbind <wl> <alias>
+```
+필요 env: `YAKCLOUD_URL`, `YAKCLOUD_TOKEN`(배포토큰 yakd_…), (선택) `YAKCLOUD_CLUSTER`
 
 ## 배포 전 1회 준비
 1. 콘솔 → 설정 → **배포 토큰** 발급(`yakd_…`).
 2. Gitea 레포 만들고 `git remote add origin …`. **Secrets**: `YAKCLOUD_URL`, `YAKCLOUD_TOKEN`, `YAKCLOUD_CLUSTER`, `REGISTRY_TOKEN`.
-3. `yakcloud.yaml` 의 `cluster`·`image` 수정.
-
-사전 점검(직접 API, 계획만):
-```sh
-YAKCLOUD_URL=https://console.yakenator.io YAKCLOUD_TOKEN=yakd_… yakcloud check
-```
+3. `yakcloud.yaml` 의 `cluster`·`image`(`<GITEA_USER>`) 수정.
 
 ## 구성
 ```
-bin/yakcloud                      # CLI(init/deploy/check)
+bin/yakcloud                      # CLI 디스패처
 install.sh                        # CLI 설치
-.claude/skills/yakcloud-deploy/   # Claude Code 스킬(SKILL.md + assets) — 프로젝트에 그대로 따라감
-app.py  Dockerfile                # 프레임워크 중립 스타터(표준 라이브러리, /healthz + PORT)
+scripts/yakcloud_deploy.py        # 리컨실 배포 CLI(매니페스트→콘솔 API)
+scripts/yakcloud_ctl.py           # info/설정 엔진(매니페스트 편집 + 라이브 PATCH)
+.claude/skills/yakcloud-deploy/   # Claude Code 스킬
+app.py  Dockerfile                # 프레임워크 중립 스타터
 yakcloud.yaml                     # 배포 매니페스트
-.gitea/workflows/deploy.yml       # 태그 push CI(매니페스트 구동 — 수정 불필요)
-scripts/yakcloud_deploy.py        # 리컨실 배포 CLI
+.gitea/workflows/deploy.yml       # 태그 push CI(매니페스트 구동)
 DATA-SOURCES.md                   # 소스별 주입 env 표
 ```
-
-## 확장(추가/삭제)
-- **워크로드/데이터소스/도메인 추가·삭제**는 `yakcloud.yaml` 을 편집하고 `yakcloud deploy` — 멱등 리컨실로 반영.
-- 상세: `.claude/skills/yakcloud-deploy/SKILL.md`.