@bifos/nhncloud-cli 0.15.0 → 0.16.0

package/README.md

@@ -64,7 +64,8 @@ nhncloud skills install
 nhncloud skills status
 ```
 
-전역 설치 없이 `npx --yes @bifos/nhncloud-cli@latest skills install` 로도 설치된다 — 관리 저장소에 복사되므로 임시 패키지 경로가 사라져도 남는다.
+전역 설치 없이 `npx --yes @bifos/nhncloud-cli@latest skills install` 로도 설치된다.
+관리 저장소에 복사되므로 임시 패키지 경로가 사라져도 남는다.
 CLI 를 새 버전으로 올린 뒤에는 `nhncloud skills update` 를 실행해야 스킬도 갱신된다.
 
 상태는 `current`, `missing`, `outdated`, `broken`, `unmanaged`, `modified`, `corrupt` 중 하나이고, 출력에 딸린 복구 명령을 따르면 된다.
@@ -103,14 +104,16 @@ nhncloud loadbalancer list                                    # 로드밸런서
 nhncloud ncr list                                             # 컨테이너 레지스트리
 nhncloud nks cluster list                                     # Kubernetes 클러스터
 nhncloud deploy artifacts                                     # 배포 아티팩트
+nhncloud logncrash available-token                            # 남은 조회 토큰과 추정 대기 시간
 nhncloud logncrash search --query '*' --from 1h --to now      # 최근 1시간 로그
+nhncloud logncrash export --query '<lucene>' --from 1h --to now --output logs.jsonl  # 대량 로그 파일 저장
 nhncloud apigateway service list                               # API Gateway 서비스
 nhncloud apigateway stage update <service-id> <stage-id> --description "설명" --yes  # API Gateway 스테이지 수정
 nhncloud apigateway stage import-resources <service-id> <stage-id> --yes             # 리소스를 스테이지로 반영
 nhncloud apigateway stage deploy create <service-id> <stage-id> --yes                 # API Gateway 스테이지 배포
 ```
 
-전체 명령과 옵션은 `--help` 로 본다. 현재 170개다.
+전체 명령과 옵션은 `--help` 로 본다.
 
 ```bash
 nhncloud --help
@@ -130,7 +133,7 @@ nhncloud commands --json | jq '.commands[] | select(.path=="nks cluster list")'
 | --- | --- | --- |
 | (없음) | 사람이 읽는 표 | 터미널 |
 | `--json` | JSON | 파싱, 명령 연결 |
-| `--quiet` | 식별자만 | 스크립트 |
+| `--quiet` | 명령이 문서화한 핵심 값 한 줄 | 스크립트 |
 
 전역 옵션이라 모든 명령에 붙일 수 있다. `--no-color` 와 `--request-timeout <sec>` 도 같은 자리에서 쓴다.
 요청 타임아웃은 초 단위이며 기본값은 30초, 허용 범위는 1~3600초다.
@@ -142,6 +145,7 @@ nhncloud commands --json | jq '.commands[] | select(.path=="nks cluster list")'
 
 ```bash
 nhncloud instance get <instance-id> --json | jq -r '.status'
+nhncloud logncrash available-token --json | jq -r '.availableToken'
 nhncloud logncrash search --query '*' --from 1h --to now --json | jq -r '.data[].logBody'
 ```
 
@@ -178,8 +182,8 @@ src/
   utils/         에러, 스피너, 종료 코드
 ```
 
-의존 방향은 `commands/` → `services/` → `api/` 이고, `utils/` 와 `formatters/` 는 그 아래에서 공유한다.
-`services/` 가 `commands/` 를 import 하지 않는다 — 역류는 금지다.
+`commands/`는 `services/`, `api/`, `config/`의 기능을 조합한다.
+`services/`가 `commands/`를 import하지 않는 경계와 상세 의존 방향은 `docs/code-architecture.md`를 기준으로 삼는다.
 
 | 문서 | 담는 것 |
 | --- | --- |
@@ -187,8 +191,8 @@ src/
 | [docs/flow.md](docs/flow.md) | 사용자 흐름 |
 | [docs/code-architecture.md](docs/code-architecture.md) | 디렉터리 트리, 레이어, 경계 |
 | [docs/data-schema.md](docs/data-schema.md) | 자격증명과 캐시 스키마 |
-| [docs/adr/INDEX.md](docs/adr/INDEX.md) | 기술 의사결정 기록 (33건) |
-| [docs/pitfalls/INDEX.md](docs/pitfalls/INDEX.md) | 반복해서 발견된 회피 패턴 (108건) |
+| [docs/adr/INDEX.md](docs/adr/INDEX.md) | 기술 의사결정 기록 |
+| [docs/pitfalls/INDEX.md](docs/pitfalls/INDEX.md) | 반복해서 발견된 회피 패턴 |
 
 ## 기여하기
 
@@ -225,7 +229,7 @@ HTTP 호출은 `ky` 만 쓰고, 사용자 오류는 `NhnCloudCliError` 와 `src/
 데이터는 stdout, 진행 상황·경고·오류는 stderr 로 분리한다.
 
 NHN Cloud API 가 문서와 다르거나 직관에 반하면 [docs/adr/](docs/adr/) 에 기록한다.
-엔드포인트 버전 이중 prefix 나 200 응답 속 `isSuccessful: false` 처럼, 모르고 접근하면 다시 막히는 것들이 이미 27건 쌓여 있다.
+엔드포인트 버전 이중 prefix 나 200 응답 속 `isSuccessful: false`처럼 직관에 반하는 동작은 관련 ADR과 반복 함정 문서에서 확인한다.
 
 ### PR 을 낼 때