@momo-kits/native-kits 0.156.1-test.9-debug → 0.156.1-tracking.2-debug

package/PUBLISH_GUIDE.md

@@ -1,90 +1,186 @@
 # Hướng Dẫn Publish NPM Package
 
-Tài liệu này hướng dẫn cách sử dụng các script publish beta và release cho `@momo-kits/native-kits`.
+Tài liệu này hướng dẫn cách sử dụng script publish cho `@momo-kits/native-kits`.
 
 ---
 
 ## 📋 Tổng Quan
 
-Dự án có 2 script publish chính:
+Dự án sử dụng **`publish.sh`** - một script thống nhất hỗ trợ 2 modes:
 
-- **`publish_beta.sh`**: Publish phiên bản beta cho testing
-- **`publish_release.sh`**: Publish phiên bản release chính thức
+- **`beta`**: Publish phiên bản beta cho testing
+- **`release`**: Publish phiên bản release chính thức
+
+Script có 3 phases riêng biệt:
+1. **Check Version**: Kiểm tra và chuẩn bị version
+2. **Publish NPM**: Publish lên NPM registry
+3. **Publish Maven**: Publish lên GitLab Maven repository
 
 ---
 
-## 🔵 Publish Beta
+## 🚀 Publish Từ Local
+
+### Yêu Cầu Trước Khi Publish
+
+1. **Login NPM:**
+   ```bash
+   npm login
+   ```
+
+2. **Kiểm tra version hiện tại:**
+   ```bash
+   cat package.json | grep version
+   ```
 
-### Khi Nào Sử Dụng?
+### 🔵 Publish Beta Từ Local
 
-- Khi cần test tính năng mới
-- Khi phát triển feature chưa hoàn thiện
-- Khi cần chia sẻ build cho team testing
+#### **Cách 1: Publish tất cả phases (Khuyến nghị)**
 
-### Cách Sử Dụng
+```bash
+sh publish.sh beta
+```
 
-#### **Phương pháp 1: Manual**
+#### **Cách 2: Chạy từng phase riêng**
 
 ```bash
-sh publish_beta.sh
+# Phase 1: Check version
+sh publish.sh beta check
+
+# Phase 2: Publish NPM
+sh publish.sh beta npm
+
+# Phase 3: Publish Maven
+sh publish.sh beta maven
 ```
 
-#### **Phương pháp 2: GitLab CI (Tự động)**
+#### **Quy Trình Beta Publishing**
+
+1. **Update version trong `package.json`:**
+   ```json
+   {
+     "version": "0.156.2"
+   }
+   ```
+
+2. **Chạy check version trước (optional nhưng khuyến nghị):**
+   ```bash
+   sh publish.sh beta check
+   ```
+
+3. **Nếu check thành công, publish:**
+   ```bash
+   sh publish.sh beta
+   ```
+
+#### **Ví Dụ Beta Publishing**
 
-Commit code với message chứa `[ci build]`:
+```bash
+# 1. Kiểm tra version
+$ cat package.json | grep version
+  "version": "0.156.2"
+
+# 2. Test check version
+$ sh publish.sh beta check
+📦 Version from package.json: 0.156.2
+🔎 Checking if version 0.156.2 already exists on npm...
+✅ Version 0.156.2 does not exist on npm. Safe to publish.
+✅ PHASE 1 COMPLETED
+
+# 3. Publish
+$ sh publish.sh beta
+🚀 PUBLISH SCRIPT - MODE: BETA
+Running ALL PHASES
+[... Phase 1: Check version ...]
+[... Phase 2: Publish NPM ...]
+   🐛 Debug version: 0.156.2-debug (with compose) - Published first
+   📦 Normal version: 0.156.2 (without compose) - Published second
+   🏷️  NPM Tag: beta
+[... Phase 3: Publish Maven ...]
+🎉 ALL PHASES COMPLETED SUCCESSFULLY!
+```
+
+#### **⚠️ Nếu Version Đã Tồn Tại**
 
 ```bash
-git commit -m "feat: add new feature [ci build]"
-git push
+$ sh publish.sh beta check
+❌ ERROR: Version 0.156.1 already exists on npm!
+
+Please update the version in package.json before publishing.
 ```
 
-### Cách Hoạt Động
+**Giải pháp:** Tăng version trong `package.json`:
+```bash
+# Mở và edit file
+vim package.json
+# hoặc
+code package.json
 
-1. **Đọc version từ `package.json`**
-2. **Publish 2 phiên bản:**
-   - **Normal version**: Không bao gồm `compose/` (cho React Native)
-   - **Debug version**: Bao gồm `compose/` với suffix `-debug`
+# Thay đổi: "version": "0.156.1" → "0.156.2"
+```
 
-### Ví Dụ
+### 🟢 Publish Release Từ Local
 
-**Trước publish:** `package.json` có `"version": "0.156.1"`
+#### **Cách 1: Publish tất cả phases (Khuyến nghị)**
 
-**Output:**
+```bash
+sh publish.sh release
 ```
-📦 Version from package.json: 0.156.1
-📤 Publishing normal version (without compose)...
-✅ Normal version published successfully!
 
-📦 Debug version: 0.156.1-debug
-📤 Publishing debug version (with compose)...
-✅ Publishing completed successfully!
+#### **Cách 2: Chạy từng phase riêng**
+
+```bash
+# Phase 1: Check version
+sh publish.sh release check
+
+# Phase 2: Publish NPM
+sh publish.sh release npm
+
+# Phase 3: Publish Maven
+sh publish.sh release maven
 ```
 
-**Kết quả trên NPM:**
-- `@momo-kits/native-kits@0.156.1` (tag: beta)
-- `@momo-kits/native-kits@0.156.1-debug` (tag: beta)
+#### **Quy Trình Release Publishing**
 
----
+1. **Version trong `package.json` có thể là bất kỳ format nào:**
+   ```json
+   {
+     "version": "0.156.1-test.5"
+   }
+   ```
+
+2. **Chạy publish:**
+   ```bash
+   sh publish.sh release
+   ```
 
-## 🟢 Publish Release
+3. **Script sẽ tự động:**
+   - Convert sang format beta: `0.156.1-test.5` → `0.156.1-beta.1`
+   - Check version trên npm
+   - Auto-increment nếu đã tồn tại: `0.156.1-beta.1` → `0.156.1-beta.2`
+   - Publish với tag `latest`
 
-### Khi Nào Sử Dụng?
+---
 
-- Khi merge code vào nhánh `main`
-- Khi release phiên bản production
-- Khi có version ổn định cần publish cho user
+## 🤖 Publish Tự Động Trên GitLab CI
 
-### Cách Sử Dụng
+### 🔵 Beta Publishing (GitLab CI)
 
-#### **Phương pháp 1: Manual**
+**Trigger:** Commit message chứa `[ci build]`
 
 ```bash
-sh publish_release.sh
+git add .
+git commit -m "feat: add new feature [ci build]"
+git push
 ```
 
-#### **Phương pháp 2: GitLab CI (Tự động)**
+**Pipeline sẽ chạy 3 stages:**
+1. `beta_check_version`
+2. `beta_publish_npm`
+3. `beta_publish_maven`
+
+### 🟢 Release Publishing (GitLab CI)
 
-Merge code vào nhánh `main`:
+**Trigger:** Push vào nhánh `main`
 
 ```bash
 git checkout main
@@ -92,193 +188,224 @@ git merge develop
 git push origin main
 ```
 
-### Cách Hoạt Động
+**Pipeline sẽ chạy 3 stages:**
+1. `release_check_version`
+2. `release_publish_npm`
+3. `release_publish_maven`
 
-1. **Đọc version từ `package.json`**
-2. **Chuẩn hóa version về format beta:**
-   - Nếu có suffix không phải `-beta.*` (ví dụ: `-test.5`, `-alpha.2`) → convert sang `-beta.1`
-   - Nếu đã là `-beta.*` → giữ nguyên
-3. **Kiểm tra version trên NPM:**
-   - Nếu version đã tồn tại → tự động tăng beta number
-   - Lặp lại cho đến khi tìm được version chưa tồn tại
-4. **Publish với tag `latest`**
+---
 
-### Ví Dụ Chi Tiết
+## 📊 So Sánh Beta vs Release
 
-#### **Ví dụ 1: Version test được convert sang beta**
+| Tiêu chí | Beta Mode | Release Mode |
+|----------|-----------|--------------|
+| **Script** | `sh publish.sh beta` | `sh publish.sh release` |
+| **Trigger CI** | Commit có `[ci build]` | Push vào `main` |
+| **Version Check** | **Fail** nếu tồn tại | **Auto-increment** |
+| **Format Version** | Giữ nguyên | Convert → `-beta.*` |
+| **NPM Tag** | `beta` | `latest` |
+| **Publish Order** | Debug first → Normal | Debug first → Normal |
 
-**Trước publish:** `package.json` có `"version": "0.156.1-test.5"`
+---
 
-**Output:**
-```
-📦 Version from package.json: 0.156.1-test.5
-🔄 Converting to beta format: 0.156.1-test.5 → 0.156.1-beta.1
-✅ Version updated to beta format: 0.156.1-beta.1
-🔎 Checking if version 0.156.1-beta.1 already exists on npm...
-⚠️  Version 0.156.1-beta.1 already exists on npm. Auto-incrementing version...
-   Version incremented: 0.156.1-beta.1 → 0.156.1-beta.2
-🔄 Checking version 0.156.1-beta.2 on npm...
-✅ Version 0.156.1-beta.2 does not exist on npm. Using this version.
-📤 Publishing...
-```
+## 🔍 Chi Tiết Các Phases
 
-**Kết quả:**
-- Publish `@momo-kits/native-kits@0.156.1-beta.2` (tag: latest)
+### **Phase 1: Check Version**
 
----
+**Beta Mode:**
+- Đọc version từ `package.json`
+- Check version trên npm
+- ❌ **FAIL** nếu version đã tồn tại
+- Update `gradle.properties`
 
-#### **Ví dụ 2: Beta version tồn tại, tự động increment nhiều lần**
+**Release Mode:**
+- Đọc version từ `package.json`
+- Convert sang format `-beta.*` nếu cần
+- Check version trên npm
+- ✅ **Auto-increment** nếu đã tồn tại
+- Update `gradle.properties`
 
-**Trước publish:** `package.json` có `"version": "0.156.1-beta.5"`
+### **Phase 2: Publish NPM**
 
-**Giả sử trên NPM đã có:**
-- `0.156.1-beta.5` ✓
-- `0.156.1-beta.6` ✓
-- `0.156.1-beta.7` ✓
+**Thứ tự publish (cả Beta và Release):**
 
-**Output:**
-```
-📦 Version from package.json: 0.156.1-beta.5
-🔎 Checking if version 0.156.1-beta.5 already exists on npm...
-⚠️  Version 0.156.1-beta.5 already exists on npm. Auto-incrementing version...
-   Version incremented: 0.156.1-beta.5 → 0.156.1-beta.6
-🔄 Checking version 0.156.1-beta.6 on npm...
-⚠️  Version 0.156.1-beta.6 already exists on npm. Auto-incrementing version...
-   Version incremented: 0.156.1-beta.6 → 0.156.1-beta.7
-🔄 Checking version 0.156.1-beta.7 on npm...
-⚠️  Version 0.156.1-beta.7 already exists on npm. Auto-incrementing version...
-   Version incremented: 0.156.1-beta.7 → 0.156.1-beta.8
-🔄 Checking version 0.156.1-beta.8 on npm...
-✅ Version 0.156.1-beta.8 does not exist on npm. Using this version.
-```
+1. **Debug version** (với compose) - Published FIRST
+   - Version: `X.Y.Z-debug`
+   - Bao gồm thư mục `compose/`
+   - Dành cho development/testing
 
-**Kết quả:**
-- Publish `@momo-kits/native-kits@0.156.1-beta.8` (tag: latest)
+2. **Normal version** (không compose) - Published SECOND
+   - Version: `X.Y.Z`
+   - Không bao gồm `compose/`
+   - Dành cho React Native apps
+
+### **Phase 3: Publish Maven**
+
+- Publish Kotlin Multiplatform artifacts
+- Lên GitLab Packages Repository
+- Dành cho `compose` module
 
 ---
 
-#### **Ví dụ 3: Version mới, không cần increment**
+## 📝 Ví Dụ Chi Tiết
 
-**Trước publish:** `package.json` có `"version": "0.157.0-beta.1"`
+### **Ví dụ 1: Beta - Version chưa tồn tại**
 
-**Output:**
-```
-📦 Version from package.json: 0.157.0-beta.1
-🔎 Checking if version 0.157.0-beta.1 already exists on npm...
-✅ Version 0.157.0-beta.1 does not exist on npm. Using this version.
+```bash
+$ sh publish.sh beta
+
+📦 Version from package.json: 0.156.2
+🔎 Checking if version 0.156.2 already exists on npm...
+✅ Version 0.156.2 does not exist on npm. Safe to publish.
+
+# Phase 2
+🐛 Debug version: 0.156.2-debug (with compose) - Published first
+📦 Normal version: 0.156.2 (without compose) - Published second
+🏷️  NPM Tag: beta
 ```
 
-**Kết quả:**
-- Publish `@momo-kits/native-kits@0.157.0-beta.1` (tag: latest)
+**Kết quả trên NPM:**
+- `@momo-kits/native-kits@0.156.2-debug` (tag: beta)
+- `@momo-kits/native-kits@0.156.2` (tag: beta)
 
----
+### **Ví dụ 2: Beta - Version đã tồn tại (FAIL)**
+
+```bash
+$ sh publish.sh beta check
 
-#### **Ví dụ 4: Version không có suffix**
+📦 Version from package.json: 0.156.1
+🔎 Checking if version 0.156.1 already exists on npm...
 
-**Trước publish:** `package.json` có `"version": "1.0.0"`
+❌ ERROR: Version 0.156.1 already exists on npm!
 
-**Output:**
+Please update the version in package.json before publishing.
+# Exit code: 1
 ```
-📦 Version from package.json: 1.0.0
-🔎 Checking if version 1.0.0 already exists on npm...
-⚠️  Version 1.0.0 already exists on npm. Auto-incrementing version...
-   Version incremented: 1.0.0 → 1.0.1
-🔄 Checking version 1.0.1 on npm...
-✅ Version 1.0.1 does not exist on npm. Using this version.
+
+### **Ví dụ 3: Release - Auto-convert và increment**
+
+```bash
+$ sh publish.sh release
+
+📦 Version from package.json: 0.156.1-test.5
+🔄 Converting to beta format: 0.156.1-test.5 → 0.156.1-beta.1
+✅ Version updated to beta format: 0.156.1-beta.1
+🔎 Checking if version 0.156.1-beta.1 already exists on npm...
+⚠️  Version 0.156.1-beta.1 already exists on npm. Auto-incrementing...
+   Version incremented: 0.156.1-beta.1 → 0.156.1-beta.2
+🔄 Checking version 0.156.1-beta.2 on npm...
+✅ Version 0.156.1-beta.2 does not exist on npm. Using this version.
 ```
 
-**Kết quả:**
-- Publish `@momo-kits/native-kits@1.0.1` (tag: latest)
+**Kết quả trên NPM:**
+- `@momo-kits/native-kits@0.156.1-beta.2-debug` (tag: latest)
+- `@momo-kits/native-kits@0.156.1-beta.2` (tag: latest)
 
----
+### **Ví dụ 4: Release - Multiple increments**
+
+```bash
+$ sh publish.sh release
 
-## 📊 So Sánh Publish Beta vs Release
+📦 Version from package.json: 0.156.1-beta.5
 
-| Tiêu chí | Publish Beta | Publish Release |
-|----------|--------------|-----------------|
-| **Script** | `publish_beta.sh` | `publish_release.sh` |
-| **Trigger CI** | Commit message có `[ci build]` | Merge vào `main` |
-| **NPM Tag** | `beta` | `latest` |
-| **Version Check** | Không | Có (tự động increment) |
-| **Format Version** | Giữ nguyên | Chuẩn hóa sang `-beta.*` |
-| **Số phiên bản publish** | 2 (normal + debug) | 1 (chỉ normal) |
+# Giả sử NPM đã có: beta.5, beta.6, beta.7
+⚠️  Version 0.156.1-beta.5 already exists on npm...
+   Version incremented: 0.156.1-beta.5 → 0.156.1-beta.6
+⚠️  Version 0.156.1-beta.6 already exists on npm...
+   Version incremented: 0.156.1-beta.6 → 0.156.1-beta.7
+⚠️  Version 0.156.1-beta.7 already exists on npm...
+   Version incremented: 0.156.1-beta.7 → 0.156.1-beta.8
+✅ Version 0.156.1-beta.8 does not exist on npm. Using this version.
+```
 
 ---
 
-## 🔧 Workflow Khuyến Nghị
+## 🎯 Workflow Khuyến Nghị
 
 ### Development Flow
 
-```mermaid
-graph LR
-    A[Develop Feature] --> B[Update version in package.json]
-    B --> C{Ready for testing?}
-    C -->|Yes| D[Commit với message ci build]
-    D --> E[publish_beta.sh chạy tự động]
-    E --> F[Team test version beta]
-    F --> G{Approved?}
-    G -->|No| A
-    G -->|Yes| H[Merge to main]
-    H --> I[publish_release.sh chạy tự động]
-    I --> J[Version release published]
+```
+┌──────────────────────────────────────────────────┐
+│ 1. Develop Feature                               │
+│    - Code changes                                │
+│    - Update version in package.json              │
+└─────────────────┬────────────────────────────────┘
+                  ↓
+┌──────────────────────────────────────────────────┐
+│ 2. Beta Testing                                  │
+│    Local: sh publish.sh beta                     │
+│    CI: git commit -m "feat: xxx [ci build]"      │
+└─────────────────┬────────────────────────────────┘
+                  ↓
+┌──────────────────────────────────────────────────┐
+│ 3. Team Testing                                  │
+│    npm install @momo-kits/native-kits@beta       │
+└─────────────────┬────────────────────────────────┘
+                  ↓
+           ┌──────┴──────┐
+           │  Approved?   │
+           └──────┬───────┘
+                  │ Yes
+                  ↓
+┌──────────────────────────────────────────────────┐
+│ 4. Release Production                            │
+│    Local: sh publish.sh release                  │
+│    CI: merge to main                             │
+└─────────────────┬────────────────────────────────┘
+                  ↓
+┌──────────────────────────────────────────────────┐
+│ 5. Production                                    │
+│    npm install @momo-kits/native-kits@latest     │
+└──────────────────────────────────────────────────┘
 ```
 
-### Bước Thực Hiện
+---
 
-1. **Development:**
-   ```bash
-   # Update version trong package.json
-   # Ví dụ: "version": "0.156.2-test.1"
-   ```
+## ⚠️ Lưu Ý Quan Trọng
 
-2. **Beta Testing:**
-   ```bash
-   git add .
-   git commit -m "feat: add new component [ci build]"
-   git push
-   # → Tự động publish beta
-   ```
+### 1. Publishing Order
 
-3. **Release Production:**
-   ```bash
-   git checkout main
-   git merge develop
-   git push origin main
-   # → Tự động publish release với version được chuẩn hóa
-   ```
+**NPM publish theo thứ tự:**
+1. ✅ Debug version (`X.Y.Z-debug`) - FIRST
+2. ✅ Normal version (`X.Y.Z`) - SECOND
 
----
+**Lý do:** Đảm bảo debug version luôn available trước
 
-## ⚠️ Lưu Ý Quan Trọng
+### 2. Version Format
 
-### 1. Format Version
+**Beta Mode:**
+- Giữ nguyên format trong `package.json`
+- Fail nếu đã tồn tại trên npm
+- ⚠️ Developer phải tự quản lý version
 
-- **Beta script**: Chấp nhận mọi format version
-- **Release script**: Tự động chuẩn hóa sang format `-beta.*`
+**Release Mode:**
+- Auto-convert sang `-beta.*` format:
   - `0.156.1-test.5` → `0.156.1-beta.1`
   - `0.156.1-alpha.2` → `0.156.1-beta.1`
   - `0.156.1-rc.3` → `0.156.1-beta.1`
-
-### 2. Auto-Increment
-
-Script release có logic tự động tăng version:
-- **Beta versions**: Tăng beta number (`-beta.5` → `-beta.6`)
-- **Regular versions**: Tăng patch number (`1.0.0` → `1.0.1`)
+- Auto-increment nếu tồn tại:
+  - Beta: `-beta.5` → `-beta.6`
+  - Regular: `1.0.0` → `1.0.1`
 
 ### 3. File Modifications
 
-Cả 2 script đều tạm thời modify các file sau (và restore lại sau khi publish):
+Script tạm thời modify các file (restore sau publish):
 - `package.json` (version)
 - `gradle.properties` (version)
 - `.npmignore` (cho debug version)
 - `compose/build.gradle.kts` (cho debug version)
 
-### 4. Requirements
+### 4. NPM Permissions
 
-Cần có quyền publish package trên NPM:
 ```bash
-# Login NPM trước khi chạy manual
+# Check account hiện tại
+npm whoami
+
+# Login nếu cần
 npm login
+
+# Verify permissions
+npm access ls-packages @momo-kits
 ```
 
 ---
@@ -287,32 +414,131 @@ npm login
 
 ### Lỗi: "Could not read version from package.json"
 
-**Nguyên nhân:** File `package.json` không hợp lệ hoặc không có field `version`
+**Nguyên nhân:** File `package.json` không hợp lệ
 
 **Giải pháp:**
 ```bash
-# Kiểm tra package.json
+# Kiểm tra syntax
+cat package.json | jq .
+
+# Kiểm tra version field
 cat package.json | grep version
 ```
 
-### Lỗi: "Version already exists on npm"
+### Lỗi: "Version already exists on npm" (Beta)
 
-**Nguyên nhân:** Chỉ với beta script - version đã được publish
+**Nguyên nhân:** Version đã được publish
 
-**Giải pháp:** 
-- Tăng version trong `package.json` manually
-- Hoặc sử dụng release script (sẽ tự động increment)
+**Giải pháp:**
+```bash
+# Option 1: Tăng version thủ công
+vim package.json
+# "version": "0.156.1" → "0.156.2"
 
-### Script không chạy trên GitLab CI
+# Option 2: Sử dụng release mode (auto-increment)
+sh publish.sh release
+```
 
-**Nguyên nhân:** Không đủ điều kiện trigger
+### Lỗi: "Permission denied"
+
+**Nguyên nhân:** Không có quyền publish package
 
 **Giải pháp:**
-- Beta: Đảm bảo commit message có `[ci build]`
-- Release: Đảm bảo đang push vào nhánh `main`
+```bash
+# 1. Kiểm tra account
+npm whoami
+
+# 2. Login với account có quyền
+npm login
+
+# 3. Liên hệ admin để cấp quyền
+```
+
+### Script không chạy trên GitLab CI
+
+**Beta không trigger:**
+- ✅ Check commit message có `[ci build]`
+- ✅ Check branch không match `engine/w*`
+
+**Release không trigger:**
+- ✅ Check đang push vào `main` branch
+- ✅ Check GitLab CI settings
+
+---
+
+## 📦 Sử Dụng Packages
+
+### Cài Đặt Beta Version
+
+```bash
+# Latest beta
+npm install @momo-kits/native-kits@beta
+
+# Specific beta version
+npm install @momo-kits/native-kits@0.156.2
+
+# Debug version (with compose)
+npm install @momo-kits/native-kits@0.156.2-debug
+```
+
+### Cài Đặt Release Version
+
+```bash
+# Latest release
+npm install @momo-kits/native-kits@latest
+# hoặc
+npm install @momo-kits/native-kits
+
+# Specific release version
+npm install @momo-kits/native-kits@0.156.1-beta.2
+```
+
+---
+
+## 🎓 Best Practices
+
+1. **Development:**
+   - Luôn test với beta trước khi release
+   - Dùng version có ý nghĩa (semantic versioning)
+
+2. **Beta Testing:**
+   - Update version mỗi lần publish beta
+   - Kiểm tra version trước khi commit
+
+3. **Release:**
+   - Chỉ release từ nhánh `main`
+   - Đảm bảo tất cả tests pass
+
+4. **Version Management:**
+   - Beta: Tự quản lý version, tăng thủ công
+   - Release: Để script auto-increment
 
 ---
 
 ## 📞 Support
 
 Nếu có vấn đề, liên hệ team hoặc tạo issue trên GitLab.
+
+---
+
+## 🔗 Quick Reference
+
+```bash
+# Beta - Local
+sh publish.sh beta                    # All phases
+sh publish.sh beta check              # Check only
+sh publish.sh beta npm                # NPM only
+sh publish.sh beta maven              # Maven only
+
+# Release - Local
+sh publish.sh release                 # All phases
+sh publish.sh release check           # Check only
+sh publish.sh release npm             # NPM only
+sh publish.sh release maven           # Maven only
+
+# Beta - CI
+git commit -m "feat: xxx [ci build]"  # Trigger beta
+
+# Release - CI
+git push origin main                  # Trigger release
+```