feat: implement release workflow, add contribution guidelines, and enhance update mechanism

Author: whnbaek

.github/workflows/release.yml

@@ -0,0 +1,74 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        include:
+          - goos: linux
+            goarch: amd64
+          - goos: linux
+            goarch: arm64
+          - goos: darwin
+            goarch: amd64
+          - goos: darwin
+            goarch: arm64
+          - goos: windows
+            goarch: amd64
+          - goos: windows
+            goarch: arm64
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: '1.25'
+
+      - name: Build
+        env:
+          GOOS: ${{ matrix.goos }}
+          GOARCH: ${{ matrix.goarch }}
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/}
+          OUTPUT=sgs-${{ matrix.goos }}-${{ matrix.goarch }}
+          if [ "${{ matrix.goos }}" = "windows" ]; then
+            OUTPUT="${OUTPUT}.exe"
+          fi
+          go build -ldflags "-X github.com/bacchus-snu/sgs-cli/internal/sgs.Version=${VERSION}" \
+            -o ${OUTPUT} ./cmd/sgs
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: sgs-${{ matrix.goos }}-${{ matrix.goarch }}
+          path: sgs-*
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Collect binaries
+        run: |
+          mkdir -p release
+          find artifacts -type f -name 'sgs-*' -exec cp {} release/ \;
+          ls -la release/
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: release/*
+          generate_release_notes: true

CONTRIBUTING.md

@@ -0,0 +1,219 @@
+# Contributing to SGS CLI
+
+Thank you for your interest in contributing to SGS CLI! This document provides guidelines and instructions for contributing.
+
+## Development Setup
+
+### Prerequisites
+
+- Go 1.25 or higher
+- Access to a Kubernetes cluster (for testing)
+- Git
+
+### Clone and Build
+
+```bash
+git clone https://github.com/bacchus-snu/sgs-cli.git
+cd sgs-cli
+go build -o bin/sgs ./cmd/sgs
+```
+
+### Running Tests
+
+```bash
+go test ./...
+```
+
+### Linting
+
+```bash
+# Install golangci-lint if not already installed
+go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
+
+# Run linter
+golangci-lint run
+```
+
+## Project Structure
+
+```text
+sgs-cli/
+├── cmd/sgs/              # Application entry point
+├── internal/
+│   ├── cleanup/          # Interrupt handling and cleanup
+│   ├── client/           # Kubernetes client, config, and updates
+│   ├── cmd/              # CLI commands (Cobra)
+│   ├── node/             # Node operations
+│   ├── session/          # Session operations
+│   ├── sgs/              # Shared constants and version
+│   ├── user/             # User identity from OIDC
+│   ├── volume/           # Volume and session management
+│   └── workspace/        # Workspace operations
+└── .github/workflows/    # CI/CD workflows
+```
+
+## Code Style
+
+- Follow standard Go conventions and idioms
+- Use `gofmt` for formatting
+- Keep functions focused and small
+- Add comments for exported functions and types
+- Error messages should be lowercase and not end with punctuation
+
+### Naming Conventions
+
+- Use camelCase for unexported identifiers
+- Use PascalCase for exported identifiers
+- Keep names concise but descriptive
+
+## Making Changes
+
+### Branch Naming
+
+- `feature/description` - New features
+- `fix/description` - Bug fixes
+- `docs/description` - Documentation updates
+- `refactor/description` - Code refactoring
+
+### Commit Messages
+
+Write clear, concise commit messages:
+
+```text
+feat: add volume copy progress indicator
+
+- Show bytes transferred during copy
+- Display estimated time remaining
+- Support quiet mode with --quiet flag
+```
+
+Prefixes:
+
+- `feat:` - New feature
+- `fix:` - Bug fix
+- `docs:` - Documentation
+- `refactor:` - Code refactoring
+- `test:` - Adding tests
+- `chore:` - Maintenance tasks
+
+### Pull Requests
+
+1. Create a feature branch from `main`
+2. Make your changes with clear commits
+3. Ensure tests pass and code is formatted
+4. Submit a PR with a clear description
+5. Address review feedback
+
+## Adding New Commands
+
+1. Create a new file in `internal/cmd/` (e.g., `mycommand.go`)
+2. Define the cobra command
+3. Register it in `init()` or add to parent command
+4. Add tests if applicable
+
+Example:
+
+```go
+package cmd
+
+import (
+    "fmt"
+    "github.com/spf13/cobra"
+)
+
+var myCmd = &cobra.Command{
+    Use:   "mycommand",
+    Short: "Short description",
+    Long:  `Longer description with examples.`,
+    Run:   runMyCommand,
+}
+
+func init() {
+    rootCmd.AddCommand(myCmd)
+}
+
+func runMyCommand(cmd *cobra.Command, args []string) {
+    // Implementation
+}
+```
+
+## Modifying Constants
+
+Constants are defined in `internal/sgs/constants.go`. These are hardcoded values used throughout the CLI:
+
+- Label keys for Kubernetes resources
+- Annotation keys
+- Default values (image, storage size)
+- Resource limits
+
+If you need to change these, ensure they match the server-side configuration.
+
+## Version and Releases
+
+### Version Format
+
+We use semantic versioning: `vMAJOR.MINOR.PATCH`
+
+- MAJOR: Breaking changes
+- MINOR: New features (backward compatible)
+- PATCH: Bug fixes
+
+### Creating a Release
+
+1. Update version-related documentation if needed
+1. Create and push a tag:
+
+   ```bash
+   git tag v1.2.3
+   git push origin v1.2.3
+   ```
+
+1. GitHub Actions will automatically:
+   - Build binaries for all platforms
+   - Create a GitHub release
+   - Attach binaries to the release
+
+### Building with Version
+
+For local builds with a specific version:
+
+```bash
+go build -ldflags "-X github.com/bacchus-snu/sgs-cli/internal/sgs.Version=v1.2.3" -o bin/sgs ./cmd/sgs
+```
+
+## Testing
+
+### Manual Testing
+
+Before submitting a PR, test your changes:
+
+```bash
+# Build
+go build -o bin/sgs ./cmd/sgs
+
+# Test basic commands
+bin/sgs version
+bin/sgs --help
+bin/sgs get --help
+```
+
+### Integration Testing
+
+If you have access to a test cluster:
+
+```bash
+bin/sgs fetch
+bin/sgs set workspace test-workspace
+bin/sgs get nodes
+bin/sgs get volumes
+```
+
+## Getting Help
+
+- Open an issue for bugs or feature requests
+- Check existing issues before creating new ones
+- Join discussions in pull requests
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

README.md

@@ -13,7 +13,7 @@ A command line interface for SNUCSE GPU Service. It provides a VM-like experienc
 
 ## Project Structure
 
-```
+```text
 sgs-cli/
 ├── cmd/
 │   └── sgs/              # Application entry point
@@ -28,7 +28,6 @@ sgs-cli/
 │   ├── user/             # User identity from OIDC tokens
 │   ├── volume/           # Volume and session management
 │   └── workspace/        # Workspace operations
-├── constants.yaml        # Configuration constants (downloaded by fetch)
 ├── go.mod
 ├── go.sum
 ├── Makefile
@@ -40,14 +39,10 @@ sgs-cli/
 SGS CLI downloads configuration files to `~/.sgs/` on first run or when `sgs fetch` is executed:
 
 - `~/.sgs/config.yaml` - Kubernetes kubeconfig for cluster access
-- `~/.sgs/constants.yaml` - Configuration constants (labels, annotations, defaults)
+- `~/.sgs/metadata.yaml` - CLI metadata (last fetch timestamp)
 - `~/.sgs/cache/` - Token cache for OIDC authentication
 
-The `constants.yaml` file is downloaded from this repository and contains configurable values like:
-
-- Kubernetes label and annotation keys
-- Default container images and resource limits
-- Runtime class configuration
+The configuration is automatically refreshed if more than 24 hours have passed since the last fetch.
 
 ## Prerequisites
 
@@ -56,6 +51,27 @@ The `constants.yaml` file is downloaded from this repository and contains config
 
 ## Installation
 
+### Download Binary
+
+Download the latest binary for your platform from [GitHub Releases](https://github.com/bacchus-snu/sgs-cli/releases):
+
+```bash
+# Linux (amd64)
+curl -LO https://github.com/bacchus-snu/sgs-cli/releases/latest/download/sgs-linux-amd64
+chmod +x sgs-linux-amd64
+sudo mv sgs-linux-amd64 /usr/local/bin/sgs
+
+# macOS (Apple Silicon)
+curl -LO https://github.com/bacchus-snu/sgs-cli/releases/latest/download/sgs-darwin-arm64
+chmod +x sgs-darwin-arm64
+sudo mv sgs-darwin-arm64 /usr/local/bin/sgs
+
+# macOS (Intel)
+curl -LO https://github.com/bacchus-snu/sgs-cli/releases/latest/download/sgs-darwin-amd64
+chmod +x sgs-darwin-amd64
+sudo mv sgs-darwin-amd64 /usr/local/bin/sgs
+```
+
 ### From Source
 
 ```bash
@@ -70,6 +86,10 @@ make build
 make install
 ```
 
+### Auto-Update
+
+When running `sgs fetch`, the CLI automatically checks for new versions and offers to update.
+
 ## Build
 
 ```bash
@@ -91,11 +111,14 @@ make clean
 ### Initial Setup
 
 ```bash
-# Download cluster configuration
+# Download cluster configuration (also checks for CLI updates)
 sgs fetch
 
 # Set your workspace
 sgs set workspace <workspace-name>
+
+# Check CLI version
+sgs version
 ```
 
 ### List Resources