@skyreve/reve 1.0.0

package/Makefile

@@ -0,0 +1,83 @@
+# 변수 설정
+BINARY_NAME=reve
+BUILD_DIR=bin
+VERSION=$(shell git describe --tags --always)
+GOOS=$(shell go env GOOS)
+GOARCH=$(shell go env GOARCH)
+LDFLAGS=-ldflags "-X main.Version=$(VERSION)"
+
+# 환경별 ldflags (BaseURL 추가)
+LDFLAGS_DEV=-ldflags "-X main.Version=$(VERSION) "
+LDFLAGS_STAG=-ldflags "-X main.Version=$(VERSION) -X reve-cli/internal/constants.BaseURL=https://api.hellreve.world"
+LDFLAGS_PROD=-ldflags "-X main.Version=$(VERSION) -X reve-cli/internal/constants.BaseURL=https://api.skyreve.cloud -X reve-cli/internal/constants.GitHubClientID=Iv23liCYhwlznxTEETKo"
+
+# 기본 빌드 (현재 OS에서 dev, stag, prod 각각 빌드)
+.PHONY: build build-dev build-stag build-prod
+
+build: build-dev build-stag build-prod
+
+build-dev:
+	@echo "🔨 Building $(BINARY_NAME) for $(GOOS)/$(GOARCH)..."
+	@mkdir -p $(BUILD_DIR)
+	@go build $(LDFLAGS_DEV) -o $(BUILD_DIR)/debug/$(BINARY_NAME)
+
+build-stag:
+	@echo "🔨 Building $(BINARY_NAME) for $(GOOS)/$(GOARCH)..."
+	@mkdir -p $(BUILD_DIR)
+	@go build $(LDFLAGS_STAG) -o $(BUILD_DIR)/staging/$(BINARY_NAME)
+
+build-prod:
+	@echo "🔨 Building $(BINARY_NAME) for $(GOOS)/$(GOARCH)..."
+	@mkdir -p $(BUILD_DIR)
+	@go build $(LDFLAGS_PROD) -o $(BUILD_DIR)/release/$(BINARY_NAME)
+
+# 실행 (예: dev 버전 실행)
+.PHONY: run
+run:
+	@echo "🚀 Running $(BINARY_NAME) ..."
+	@./$(BUILD_DIR)/debug/$(BINARY_NAME)
+
+# 테스트 실행
+.PHONY: test
+test:
+	@echo "🧪 Running tests..."
+	@go test ./... -cover -v
+
+# 린트 실행
+.PHONY: lint
+lint:
+	@echo "🔍 Running linter..."
+	@go install golang.org/x/lint/golint@latest
+	@golint ./...
+
+# 여러 플랫폼 빌드 (각 환경별, loop 없이 직접 나열)
+.PHONY: build-all build-all-dev build-all-stg build-all-release
+
+build-all: build-all-dev build-all-stg build-all-release
+
+build-all-dev:
+	@echo "🔨 Building debug binaries for multiple platforms ..."
+	@GOOS=linux GOARCH=amd64 go build $(LDFLAGS_DEV) -o $(BUILD_DIR)/debug/linux/$(BINARY_NAME)
+	@GOOS=darwin GOARCH=arm64 go build $(LDFLAGS_DEV) -o $(BUILD_DIR)/debug/darwin/$(BINARY_NAME)
+	@GOOS=windows GOARCH=amd64 go build $(LDFLAGS_DEV) -o $(BUILD_DIR)/debug/windows/$(BINARY_NAME).exe
+
+build-all-stg:
+	@echo "🔨 Building staging binaries for multiple platforms ..."
+	@GOOS=linux GOARCH=amd64 go build $(LDFLAGS_STAG) -o $(BUILD_DIR)/staging/linux/$(BINARY_NAME)
+	@GOOS=darwin GOARCH=arm64 go build $(LDFLAGS_STAG) -o $(BUILD_DIR)/staging/darwin/$(BINARY_NAME)
+	@GOOS=windows GOARCH=amd64 go build $(LDFLAGS_STAG) -o $(BUILD_DIR)/staging/windows/$(BINARY_NAME).exe
+
+build-all-release:
+	@echo "🔨 Building release binaries for multiple platforms ..."
+	@GOOS=linux GOARCH=amd64 go build $(LDFLAGS_PROD) -o $(BUILD_DIR)/release/linux/$(BINARY_NAME)
+	@GOOS=darwin GOARCH=arm64 go build $(LDFLAGS_PROD) -o $(BUILD_DIR)/release/darwin/$(BINARY_NAME)
+	@GOOS=windows GOARCH=amd64 go build $(LDFLAGS_PROD) -o $(BUILD_DIR)/release/windows/$(BINARY_NAME).exe
+
+# 정리 (빌드 결과 삭제)
+.PHONY: clean
+clean:
+	@echo "🧹 Cleaning up..."
+	@rm -rf $(BUILD_DIR)
+
+# 기본 목표 (build 실행 시 dev, stag, prod 3개 빌드)
+.DEFAULT_GOAL := build

package/README.md

@@ -0,0 +1,248 @@
+# Reve CLI - Command Line Interface
+
+Reve CLI는 Reve 프로젝트를 위한 커맨드라인 도구입니다.  
+이 문서는 Reve CLI를 설치하고 사용하는 방법을 설명합니다.
+
+---
+
+## **1. 설치 방법 (Installation)**
+
+### **1.1 npm을 통한 설치 (권장)**
+다른 npm 프로젝트에서 Reve CLI를 사용하려면:
+```bash
+npm install @skyreve/reve
+```
+
+설치 후 `npx reve` 명령어로 실행할 수 있습니다:
+```bash
+npx reve --help
+npx reve status
+npx reve init
+```
+
+### **1.2 글로벌 설치**
+전역적으로 설치하려면:
+```bash
+npm install -g @skyreve/reve
+```
+
+설치 후 `reve` 명령어로 직접 실행할 수 있습니다:
+```bash
+reve --help
+reve status
+reve init
+```
+
+---
+
+## **2. 개발 환경 설정 (Development Setup)**
+
+### **1.1 Go 설치**
+Reve CLI는 **Go**를 필요로 합니다. Go가 설치되지 않았다면 아래 명령어로 설치하세요:
+```bash
+brew install go
+```
+
+### **1.2 프로젝트 초기화**
+프로젝트를 클론하고 의존성을 설치합니다:
+```bash
+git clone git@github.com:SkyReve/reve-cli.git
+cd reve-cli
+go mod tidy
+```
+
+---
+
+## **2. 빌드 (Build)**
+
+### **2.1 npm 스크립트를 통한 빌드 (권장)**
+npm을 통해 다양한 환경별로 빌드할 수 있습니다:
+
+#### **개발 환경 빌드**
+```bash
+npm run build-dev
+```
+
+#### **스테이징 환경 빌드**
+```bash
+npm run build-staging
+```
+
+#### **운영 환경 빌드**
+```bash
+npm run build
+```
+
+#### **정리**
+```bash
+npm run clean
+```
+
+### **2.2 Makefile을 통한 빌드**
+
+#### **현재 OS에서 환경별 바이너리 빌드**
+현재 OS에서 **개발(debug), 스테이징(staging), 운영(release)** 환경별로 바이너리를 생성하려면:
+```bash
+make
+```
+또는 개별 환경별로:
+```bash
+make build-dev      # 개발 환경
+make build-stag     # 스테이징 환경  
+make build-prod     # 운영 환경
+```
+
+빌드가 완료되면, `bin/` 디렉토리에 아래 구조로 파일들이 생성됩니다:
+```bash
+bin/
+├── debug/reve
+├── staging/reve
+└── release/reve
+```
+
+#### **모든 OS(Linux, macOS, Windows)용 바이너리 빌드**
+```bash
+make build-all
+```
+또는 개별 환경별로:
+```bash
+make build-all-dev      # 개발 환경 (모든 OS)
+make build-all-stg      # 스테이징 환경 (모든 OS)
+make build-all-release  # 운영 환경 (모든 OS)
+```
+
+모든 OS에 대한 바이너리를 빌드하면 아래와 같은 구조로 파일이 생성됩니다:
+```bash
+bin/
+├── debug/
+│   ├── linux/reve
+│   ├── darwin/reve
+│   └── windows/reve.exe
+├── staging/
+│   ├── linux/reve
+│   ├── darwin/reve
+│   └── windows/reve.exe
+└── release/
+    ├── linux/reve
+    ├── darwin/reve
+    └── windows/reve.exe
+```
+
+### **2.3 빌드된 바이너리 확인**
+빌드된 바이너리는 `bin/` 디렉토리에 저장됩니다. 확인하려면:
+```bash
+ls -la bin/
+# 또는
+tree bin/
+```
+
+---
+
+## **3. 환경별 바이너리 설명**
+Reve CLI는 환경별로 다른 API 서버를 사용하도록 빌드됩니다.
+
+### **🔹 debug 환경 (개발)**
+- **바이너리 경로:** `bin/debug/reve` (단일 OS) 또는 `bin/debug/{os}/reve` (모든 OS)
+- **BaseURL:** `http://127.0.0.1:8000` (기본값)
+- **설명:** 개발 환경용 바이너리입니다. 새로운 기능을 테스트하고 디버깅할 때 사용합니다.
+
+### **🔹 staging 환경 (스테이징)**
+- **바이너리 경로:** `bin/staging/reve` (단일 OS) 또는 `bin/staging/{os}/reve` (모든 OS)
+- **BaseURL:** `https://api.hellreve.world`
+- **설명:** 스테이징 환경용 바이너리입니다. 운영 환경과 유사한 조건에서 최종 QA 및 검증에 사용됩니다.
+
+### **🔹 release 환경 (운영)**
+- **바이너리 경로:** `bin/release/reve` (단일 OS) 또는 `bin/release/{os}/reve` (모든 OS)
+- **BaseURL:** `https://api.skyreve.cloud`
+- **GitHub Client ID:** `Iv23liCYhwlznxTEETKo`
+- **설명:** 운영(프로덕션) 환경용 바이너리입니다. 실제 사용자에게 제공되는 서비스 환경에서 사용됩니다.
+
+---
+
+## **4. Reve CLI 사용법 (Using `reve`)**
+
+### **4.1 npm을 통한 실행 (권장)**
+npm으로 설치한 경우:
+```bash
+npx reve [COMMAND] [OPTIONS]
+# 또는 글로벌 설치한 경우
+reve [COMMAND] [OPTIONS]
+```
+
+### **4.2 바이너리 직접 실행**
+빌드된 바이너리를 직접 실행하는 경우:
+```bash
+# 개발 환경
+./bin/debug/reve [COMMAND] [OPTIONS]
+
+# 스테이징 환경  
+./bin/staging/reve [COMMAND] [OPTIONS]
+
+# 운영 환경
+./bin/release/reve [COMMAND] [OPTIONS]
+```
+
+### **4.3 도움말 확인**
+```bash
+reve --help
+# 또는
+npx reve --help
+```
+
+### **4.4 주요 명령어**
+| 명령어 | 설명 |
+|--------|------|
+| `reve init` | SkyReve 프로젝트 초기화 |
+| `reve sync` | 원격 데이터와 동기화 |
+| `reve status` | 프로젝트 상태 확인 |
+| `reve deploy` | 프로젝트 배포 |
+| `reve switch` | 프로젝트 및 브랜치 전환 |
+| `reve github-init` | GitHub 연동 초기화 |
+| `reve github-link` | GitHub 저장소 연결 |
+| `reve github-unlink` | GitHub 저장소 연결 해제 |
+
+---
+
+## **5. 기타 (Additional Information)**
+
+### **5.1 실행 방법**
+빌드된 바이너리를 실행하려면:
+```bash
+# 개발 환경
+./bin/debug/reve --help
+
+# 스테이징 환경
+./bin/staging/reve --help
+
+# 운영 환경
+./bin/release/reve --help
+```
+
+### **5.2 정리 (Clean)**
+불필요한 빌드 파일을 정리하려면:
+```bash
+# npm 스크립트 사용
+npm run clean
+
+# 또는 Makefile 사용
+make clean
+```
+
+### **5.3 테스트 및 린트**
+```bash
+# 테스트 실행
+make test
+
+# 린트 실행
+make lint
+```
+
+### **5.4 개발 모드 실행**
+개발 중 빠른 테스트를 위해:
+```bash
+make run
+```
+
+---
+
+### **🛠 이제 SkyReve CLI를 사용할 준비가 완료되었습니다! 🚀**

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@skyreve/reve",
+  "version": "1.0.0",
+  "description": "Reve CLI - A command line tool for Reve platform",
+  "main": "index.js",
+  "scripts": {
+    "reve": "node scripts/reve.js",
+    "build": "make build-all-release",
+    "build-dev": "make build-all-dev",
+    "build-staging": "make build-all-stg",
+    "clean": "make clean"
+  },
+  "bin": {
+    "reve": "./scripts/reve.js"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/skyreve/reve-cli.git"
+  },
+  "keywords": [
+    "cli",
+    "reve",
+    "command-line",
+    "tool"
+  ],
+  "author": "SkyReve",
+  "license": "MIT",
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE",
+    "Makefile"
+  ],
+  "preferGlobal": true
+}

package/scripts/reve.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+// OS별 바이너리 경로 결정
+const getBinaryPath = () => {
+  const platform = os.platform();
+  const arch = os.arch();
+  
+  // 플랫폼별 디렉토리 매핑
+  const platformMap = {
+    'darwin': 'darwin',
+    'linux': 'linux', 
+    'win32': 'windows'
+  };
+  
+  const platformDir = platformMap[platform] || 'linux';
+  const binDir = path.join(__dirname, '..', 'bin', 'release', platformDir);
+  
+  // Windows의 경우 .exe 확장자 추가
+  const binaryName = platform === 'win32' ? 'reve.exe' : 'reve';
+  const binaryPath = path.join(binDir, binaryName);
+  
+  return binaryPath;
+};
+
+// 바이너리 존재 확인
+const checkBinaryExists = (binaryPath) => {
+  try {
+    return fs.existsSync(binaryPath);
+  } catch (error) {
+    return false;
+  }
+};
+
+// 바이너리 실행
+const runBinary = (binaryPath, args) => {
+  const options = {
+    stdio: 'inherit',
+    cwd: process.cwd()
+  };
+  
+  const child = spawn(binaryPath, args, options);
+  
+  child.on('error', (error) => {
+    console.error(`❌ Reve binary execution error: ${error.message}`);
+    process.exit(1);
+  });
+  
+  child.on('exit', (code) => {
+    process.exit(code);
+  });
+};
+
+// 메인 실행 함수
+const main = () => {
+  const binaryPath = getBinaryPath();
+  
+  // 바이너리 존재 확인
+  if (!checkBinaryExists(binaryPath)) {
+    console.error(`❌ Reve binary not found: ${binaryPath}`);
+    console.error('Please run build first: npm run build');
+    process.exit(1);
+  }
+  
+  // 명령행 인수 전달 (node와 스크립트 이름 제외)
+  const args = process.argv.slice(2);
+  
+  // 바이너리 실행
+  runBinary(binaryPath, args);
+};
+
+// 스크립트가 직접 실행된 경우에만 실행
+if (require.main === module) {
+  main();
+}
+
+module.exports = { getBinaryPath, checkBinaryExists, runBinary };