shopport 0.4.3 → 0.5.0

package/dist/skills/order-collect/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: sppt-order-collect
 description: |
-  멀티채널 주문을 한번에 모아보는 워크플로우.
-  Use when asked to "주문 모아줘", "전채널 주문 조회", "오늘 주문 몇 개야", "주문 동기화해줘".
+  멀티채널 주문을 한번에 모으거나 CSV/XLSX 파일로 내보내는 워크플로우.
+  Use when asked to "주문 모아줘", "전채널 주문 조회", "오늘 주문 몇 개야", "주문 동기화해줘", "주문 CSV로 뽑아줘".
 ---
 
 # order-collect
@@ -12,6 +12,7 @@ description: |
 ## When to use
 
 - "오늘 주문 몇 개야?", "주문 모아줘", "전채널 주문 현황" 요청 시
+- "최근 1개월 주문데이터 CSV로 뽑아줘", "지난달 주문 엑셀로 줘" 요청 시
 - 매일 아침 주문 현황 파악할 때
 - 멀티채널 주문을 한눈에 보고 싶을 때
 - 정산/분석을 위해 주문 데이터를 처음 수집할 때
@@ -23,6 +24,21 @@ description: |
 
 ## Steps
 
+### 0. 파일 내보내기 요청
+
+사용자가 주문 파일을 요청하면 채널별 목록을 따로 출력하지 않고 아래 명령을 바로 실행합니다.
+
+```bash
+sppt order export all --period 30d --format csv
+```
+
+- "최근 1개월"은 `--period 30d`, "지난달"은 `--period last-month`로 해석합니다.
+- 엑셀 파일을 명시하면 `--format xlsx`를 사용합니다.
+- 기본 파일에는 수령인·전화번호·주소가 없습니다. 출고 목적으로 개인정보가 필요한 경우에만 `--include-pii`를 추가합니다.
+- 완료 후 파일 경로, 주문상품 행 수, 제외된 채널과 사유를 사용자에게 알립니다.
+
+파일 요청이 아니면 아래 수집·요약 단계를 따릅니다.
+
 ### 1. 채널 상태 확인
 
 ```bash

package/dist/skills/shopport/SKILL.md

@@ -15,6 +15,17 @@ description: |
 sppt --help
 ```
 
+## 에이전트 인증
+
+브라우저를 열 수 없는 에이전트는 발급받은 원문 토큰을 표준 입력으로 등록한다.
+
+```bash
+printf %s "$SHOPPORT_AGENT_TOKEN" | sppt auth token set --stdin
+sppt auth whoami
+```
+
+`sppt auth token remove`는 이 기기의 등록값만 지우며 서버 토큰을 폐기하지 않는다.
+
 ## 사용 가능한 스킬
 
 | 스킬 | 설명 |
@@ -63,17 +74,6 @@ sppt settlement deposit <file.csv>   # 은행 입금 내역 CSV 임포트 (KB·
 sppt settlement deposit delete --date YYYY-MM-DD --provider <입금처>  # 입금 내역 삭제
 ```
 
-## 인증
-
-```bash
-sppt auth login --no-browser
-sppt auth token create --name <name> [--ttl-days 30]
-printf %s "$SHOPPORT_AGENT_TOKEN" | sppt auth token set --stdin
-sppt auth token remove
-sppt auth token list
-sppt auth token revoke <id>
-```
-
 ## 쿠폰
 
 ```bash
@@ -82,7 +82,7 @@ sppt coupon get cafe24 <coupon_no> [--json]
 sppt coupon issues cafe24 <coupon_no> [--member <member_id>] [--order-status <status>] [--json]
 sppt coupon revoke cafe24 <member_id> <coupon_no> [--confirm]
 sppt coupon link cafe24 <coupon_no[,coupon_no...]> [--domain <domain>] [--copy]
-sppt coupon create <channel> --name <name> --benefit <amount|rate> --value <N>  # cafe24는 지정 회원 발급용만
+sppt coupon create <channel> --name <name> --type <type> --value <N>
 sppt coupon issue <channel> <couponId> --members <id1,id2,...>
 sppt coupon support
 ```

package/dist/skills/sppt/SKILL.md

@@ -55,8 +55,8 @@ sppt crm cafe24 customers  # cafe24 회원목록 조회
     - `sppt init 29cm --client-id <id> --client-secret <secret> --partner-key <key>`
     - `sppt init musinsa --api-key <key> --api-secret <secret>`
 - `sppt auth login` — 브라우저 OAuth 로그인
-- `sppt auth login --no-browser` — 원격/헤드리스 에이전트용 device code 로그인
-- `sppt auth token create --name <name> [--ttl-days 30]` — 에이전트용 `SHOPPORT_CLOUD_TOKEN` 발급
+- `sppt auth login --no-browser` — 원격/헤드리스 환경의 device code 로그인
+- `sppt auth token create --name <name> [--ttl-days 30]` — 에이전트용 토큰 발급
 - `printf %s "$SHOPPORT_AGENT_TOKEN" | sppt auth token set --stdin` — 브라우저 없이 agent token 등록·서버 검증
 - `sppt auth token remove` — 이 기기에 등록한 agent token만 제거 (서버 폐기 아님)
 - `sppt auth token list|revoke <id>` — 에이전트 토큰 목록/폐기
@@ -155,7 +155,7 @@ sppt crm cafe24 customers  # cafe24 회원목록 조회
 - `sppt coupon issues cafe24 <coupon_no> [--member <member_id>] [--order-status <status>] [--json]` — 쿠폰 발급내역 조회
 - `sppt coupon revoke cafe24 <member_id> <coupon_no> [--confirm]` — 회원 쿠폰 회수 (`--confirm` 없으면 dry-run)
 - `sppt coupon link cafe24 <coupon_no[,coupon_no...]> [--domain <domain>] [--copy]` — 쿠폰 다운로드 URL 조립
-- `sppt coupon create <channel> --name <name> --benefit <amount|rate> --value <N>` — 쿠폰 생성 (cafe24는 지정 회원 발급용만)
+- `sppt coupon create <channel> --name <name> --type <type> --value <N>` — 쿠폰 생성
 - `sppt coupon issue <channel> <couponId> --members <id1,id2,...>` — 쿠폰 발급
 - `sppt coupon support` — 채널별 쿠폰 기능 지원 현황
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shopport",
-	"version": "0.4.3",
+	"version": "0.5.0",
 	"description": "커머스 운영 자동화 CLI — Cafe24, Coupang, SmartStore, Shopify 통합 관리",
 	"type": "module",
 	"bin": {