@skyreve/reve 1.0.21 → 1.0.24

package/README.md

@@ -53,10 +53,8 @@ reve github login
 reve github install
 reve env link <skyreve-project-env-name_or_id>
 reve env sync
-# todo
-reve gen test # AI
-reve gen api # AI
-reve gen table # AI
+reve compile
+reve code [table-name]
 ```
 
 ---
@@ -65,7 +63,7 @@ reve gen table # AI
 
 ### **2.1 Install Go**
 
-Reve CLI requires **Go**. If Go is not installed, install it using the following commands:
+Reve CLI requires **Go 1.24.0 or higher**. If Go is not installed, install it using the following commands:
 
 **macOS:**
 
@@ -237,18 +235,17 @@ npx reve --help
 
 #### **🔹 Basic Commands**
 
-| Command              | Description                                                                     |
-| -------------------- | ------------------------------------------------------------------------------- |
-| `reve start`         | **Quick Start**: Complete 6-step setup process and start environment management |
-| `reve login [email]` | Login to SkyReve platform                                                       |
-| `reve project`       | Select/create SkyReve project to work with                                      |
+| Command               | Description                                                                     |
+| --------------------- | ------------------------------------------------------------------------------- |
+| `reve start`          | **Quick Start**: Complete 5-step setup process and start environment management |
+| `reve start --force`  | Force all 5 setup steps even if already configured                              |
+| `reve login [email]`  | Login to SkyReve platform                                                       |
+| `reve project`        | Select/create SkyReve project to work with                                      |
 
 #### **🔹 Environment Management Commands (`reve env`)**
 
 | Command                    | Description                                                                 |
 | -------------------------- | --------------------------------------------------------------------------- |
-| `reve env`                 | Start interactive environment management (same as `reve env start`)         |
-| `reve env start`           | Start interactive environment management                                    |
 | `reve env info`            | Check project info, Git repository info, and GitHub App installation status |
 | `reve env list`            | List all Reve environments with linked GitHub branch information            |
 | `reve env link <reve_env>` | Link GitHub branch to specific Reve environment                             |
@@ -264,28 +261,34 @@ npx reve --help
 
 #### **🔹 Developer Commands**
 
-| Command                  | Description                                        |
-| ------------------------ | -------------------------------------------------- |
-| `reve compile`           | Validate `src/tables` and `src/apis` configuration |
-| `reve code [table-name]` | Generate admin API code and helpers (smart update) |
+| Command                              | Description                                                               |
+| ------------------------------------ | ------------------------------------------------------------------------- |
+| `reve compile`                       | Validate `src/tables` and `src/apis` configuration for errors/warnings    |
+| `reve code [table-name]`             | Generate admin REST API code and helper files (smart update)              |
+| `reve code [table-name] --force`     | Force regenerate all functions (overwrites existing files)                |
+| `reve code [table-name] -m <method>` | Generate specific methods only (list, create, detail, delete, update)     |
+| `reve code -m help`                  | Generate helper files only (serializers, APIs)                            |
+| `reve code -m test`                  | Generate Jest test setup files (package.json, tests/, setup.js)           |
 
 ### **5.5 Usage Examples**
 
 #### **First-time Setup (Recommended)**
 
 ```bash
-# 1. Complete 6-step setup process (Quick Start)
+# 1. Complete 5-step setup process (Quick Start)
 reve start
+
+# Force all steps even if already configured
+reve start --force
 ```
 
-This **Quick Start** command automatically performs the following 6 steps:
+This **Quick Start** command automatically performs the following 5 steps:
 
-1. **🔐 Step 1/6**: Login to SkyReve platform
-2. **📁 Step 2/6**: Select/create a project
-3. **🐙 Step 3/6**: Login to GitHub
-4. **🔧 Step 4/6**: Install GitHub App
-5. **📦 Step 5/6**: Link GitHub branch to Reve environment
-6. **🚀 Step 6/6**: Start syncing Reve environment
+1. **🔐 Step 1/5**: Login to SkyReve platform
+2. **📁 Step 2/5**: Select/create a project
+3. **🐙 Step 3/5**: Login to GitHub
+4. **🔧 Step 4/5**: Install GitHub App
+5. **📦 Step 5/5**: Link GitHub branch to Reve environment
 
 After completion, you'll see: `🎉 All setup steps completed successfully!`
 
@@ -304,8 +307,9 @@ reve github login
 # 4. Install GitHub App
 reve github install
 
-# 5. Start environment management
-reve env start
+# 5. Check environment list and link a branch
+reve env list
+reve env link <env-name>
 ```
 
 #### **Daily Usage**
@@ -333,8 +337,30 @@ reve env deploy --force
 
 Reve CLI includes powerful code generation and validation tools:
 
-- **`reve compile`**: Validates schema consistency across tables and APIs
-- **`reve code`**: Generates Python helpers with smart update capability (preserves user-defined functions) and handles conflict detection
+- **`reve compile`**: Validates schema consistency across tables and APIs — checks for duplicate `meta_id`, invalid references, missing partner files, and module/function existence
+- **`reve code [table-name]`**: Generates admin REST API code and helper files with smart update capability (preserves user-defined functions). Omit `[table-name]` to process all tables in `src/tables/`
+
+**`reve code` flags:**
+
+```bash
+# Generate code for a specific table
+reve code user
+
+# Process all tables in src/tables/
+reve code
+
+# Force regenerate (overwrite existing files)
+reve code user --force
+
+# Generate specific HTTP methods only
+reve code user -m list,create,detail
+
+# Generate helper files only (serializers, APIs)
+reve code user -m help
+
+# Generate Jest test setup files
+reve code -m test
+```
 
 The `reve env sync` command automatically generates the following files in your project:
 
@@ -573,45 +599,60 @@ npm unpublish @skyreve/reve@<version>
 
 ```
 reve-cli/
-├── cmd/                    # Command definitions
-│   ├── root.go            # Root command with logging and config
-│   ├── start.go           # Complete setup start command (6-step process)
-│   ├── login.go           # SkyReve platform login with email/password
-│   ├── project.go         # Project selection/creation
-│   ├── env.go             # Environment management command group
-│   ├── github.go          # GitHub related commands group
-│   ├── env/               # Environment management sub-commands
-│   │   ├── start.go       # Interactive environment management
-│   │   ├── info.go        # Project and environment information
-│   │   ├── list.go        # List all environments with branch info
-│   │   ├── link.go        # Link GitHub branch to environment
-│   │   ├── sync.go        # Sync files (settings, tables, APIs, libs)
-│   │   ├── deploy.go      # Deploy to environment
-│   │   └── common.go      # Common environment functions
-│   └── github/            # GitHub sub-commands
-│       ├── login.go       # GitHub Device Flow authentication
-│       └── install.go     # GitHub App installation
-├── internal/              # Internal packages
-│   ├── api/              # SkyReve API client and data structures
-│   ├── config/           # Configuration management (.reve directory)
-│   ├── constants/        # Application constants
-│   ├── gen/              # File generation (YAML files for tables, APIs, etc.)
-│   ├── git/              # Git repository operations
-│   ├── github/           # GitHub API client
-│   ├── http/             # HTTP client utilities
-│   ├── logger/           # Logging system
-│   ├── reve/             # SkyReve platform utilities
-│   └── cmd_common/       # Common command utilities
-├── scripts/              # Node.js wrapper scripts
-│   └── reve.js           # Cross-platform binary launcher
-├── bin/                  # Built binaries (platform-specific)
-├── samples/              # Example files and configurations
-├── tests/                # Test files
-├── main.go               # Application entry point
-├── package.json          # npm package configuration
-├── go.mod               # Go module definition
-├── Makefile             # Build and development commands
-└── README.md           # This file
+├── cmd/                        # Command definitions
+│   ├── root.go                 # Root command with logging and config
+│   ├── start.go                # Complete setup start command (5-step process)
+│   ├── login.go                # SkyReve platform login with email/password
+│   ├── project.go              # Project selection/creation
+│   ├── env.go                  # Environment management command group
+│   ├── github.go               # GitHub related commands group
+│   ├── compile.go              # Schema validation for tables and APIs
+│   ├── code.go                 # Code generation entry point
+│   ├── env/                    # Environment management sub-commands
+│   │   ├── info.go             # Project and environment information
+│   │   ├── list.go             # List all environments with branch info
+│   │   ├── link.go             # Link GitHub branch to environment
+│   │   ├── sync.go             # Sync files (settings, tables, APIs, libs)
+│   │   ├── deploy.go           # Deploy to environment
+│   │   └── common.go           # Common environment functions
+│   ├── github/                 # GitHub sub-commands
+│   │   ├── login.go            # GitHub Device Flow authentication
+│   │   ├── install.go          # GitHub App installation
+│   │   └── common.go           # Shared GitHub helpers
+│   └── code/                   # Code generation implementations
+│       ├── admin.go            # Admin REST API code generation
+│       ├── helper.go           # Helper file generation
+│       ├── test_jest_gen.go    # Jest test setup generation
+│       ├── admins/             # Admin API templates (list, create, detail, update, delete)
+│       ├── helpers/            # Helper templates (serializers, APIs, copy)
+│       └── test_jest/          # Jest test templates (package.json, setup)
+├── internal/                   # Internal packages
+│   ├── api/                    # SkyReve REST API client (endpoints & data types)
+│   ├── config/                 # Configuration management (.reve directory)
+│   ├── constants/              # Application constants (URLs, GitHub App IDs by env)
+│   ├── gen/                    # File generation (YAML for tables, APIs, settings, libs)
+│   ├── git/                    # Git repository operations
+│   ├── github/                 # GitHub API client (OAuth, user info)
+│   ├── http/                   # HTTP client utilities
+│   ├── logger/                 # Logging system (with log rotation)
+│   ├── python/                 # Python code parsing and modification
+│   ├── util/                   # General utilities (files, strings, validation)
+│   └── cmd_common/             # Common command utilities
+├── version/                    # Version management
+│   └── version.go              # Version & git hash (injected at build time)
+├── scripts/                    # Node.js wrapper scripts
+│   └── reve.js                 # Cross-platform binary launcher
+├── bin/                        # Built binaries (platform-specific)
+├── docs/                       # Documentation
+│   └── TESTING.md              # Testing guide (unit, integration, CI/CD)
+├── testdata/                   # Sample configurations for tests
+├── tests/                      # Integration test utilities
+├── main.go                     # Application entry point
+├── package.json                # npm package configuration
+├── go.mod                      # Go module definition (Go 1.24.0)
+├── Makefile                    # Build and development commands
+├── README.md                   # This file
+└── README.npm.md               # Condensed README for npm registry
 ```
 
 ### **8.1 Key Components**
@@ -646,7 +687,7 @@ reve-cli/
 ## **9. Requirements**
 
 - **Node.js**: 14.0.0 or higher
-- **Go**: Latest stable version
+- **Go**: 1.24.0 or higher
 - **Supported OS**: macOS, Linux, Windows
 - **Supported Architectures**: x64, arm64
 

package/README.npm.md

@@ -40,16 +40,18 @@ The easiest way to get started with Reve is using the **Quick Start** command:
 
 ```bash
 reve start
+
+# Force all steps even if already configured
+reve start --force
 ```
 
-This command will guide you through a complete 6-step setup process:
+This command will guide you through a complete 5-step setup process:
 
-1. **🔐 Step 1/6**: Login to SkyReve platform
-2. **📁 Step 2/6**: Select/create a project
-3. **🐙 Step 3/6**: Login to GitHub
-4. **🔧 Step 4/6**: Install GitHub App
-5. **📦 Step 5/6**: Link GitHub branch to Reve environment
-6. **🚀 Step 6/6**: Start syncing Reve environment
+1. **🔐 Step 1/5**: Login to SkyReve platform
+2. **📁 Step 2/5**: Select/create a project
+3. **🐙 Step 3/5**: Login to GitHub
+4. **🔧 Step 4/5**: Install GitHub App
+5. **📦 Step 5/5**: Link GitHub branch to Reve environment
 
 After completion, you'll see: `🎉 All setup steps completed successfully!`
 
@@ -57,20 +59,22 @@ After completion, you'll see: `🎉 All setup steps completed successfully!`
 
 ### Main Commands
 
-| Command                  | Description                                    |
-| ------------------------ | ---------------------------------------------- |
-| `reve start`             | **Quick Start**: Complete 6-step setup process |
-| `reve login [email]`     | Login to SkyReve platform                      |
-| `reve project`           | Select/create SkyReve project                  |
-| `reve env`               | Start interactive environment management       |
-| `reve env list`          | List all Reve environments                     |
-| `reve env link <env>`    | Link GitHub branch to Reve environment         |
-| `reve env sync`          | Sync current branch with Reve environment      |
-| `reve env deploy`        | Deploy current branch to Reve environment      |
-| `reve github login`      | Login to GitHub using Device Flow              |
-| `reve github install`    | Install GitHub App for current repository      |
-| `reve compile`           | Validate configuration files                   |
-| `reve code [table-name]` | Generate admin API code                        |
+| Command                  | Description                                                             |
+| ------------------------ | ----------------------------------------------------------------------- |
+| `reve start`             | **Quick Start**: Complete 5-step setup process                          |
+| `reve start --force`     | Force all 5 setup steps even if already configured                      |
+| `reve login [email]`     | Login to SkyReve platform                                               |
+| `reve project`           | Select/create SkyReve project                                           |
+| `reve env`               | Start interactive environment management                                |
+| `reve env info`          | Show project info, Git repository info, and GitHub App installation status |
+| `reve env list`          | List all Reve environments with linked GitHub branch information        |
+| `reve env link <env>`    | Link GitHub branch to Reve environment                                  |
+| `reve env sync`          | Sync current branch with Reve environment                               |
+| `reve env deploy`        | Deploy current branch to Reve environment                               |
+| `reve github login`      | Login to GitHub using Device Flow                                       |
+| `reve github install`    | Install GitHub App for current repository                               |
+| `reve compile`           | Validate `src/tables` and `src/apis` configuration files                |
+| `reve code [table-name]` | Generate admin REST API code and helper files                           |
 
 ### Getting Help
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@skyreve/reve",
-	"version": "1.0.21",
+	"version": "1.0.24",
 	"description": "Reve - A command line tool for Reve platform",
 	"main": "index.js",
 	"scripts": {