kodevu 0.1.44 → 0.1.45

package/README.md

@@ -12,25 +12,13 @@ Kodevu is designed to be stateless and requires no configuration files. It relie
 
 ## Quick Start
 
-Review the latest commit in your repository:
+Get a review of your latest commit in seconds:
 
 ```bash
 npx kodevu .
 ```
 
-Review the latest 3 commits:
-
-```bash
-npx kodevu . --last 3
-```
-
-Review a specific commit:
-
-```bash
-npx kodevu . --rev abc1234
-```
-
-Reports are written to `~/.kodevu/` by default.
+Review reports are saved to `~/.kodevu/` by default.
 
 ## Usage
 
@@ -43,7 +31,7 @@ npx kodevu [target] [options]
 - `target`: Repository path (Git) or SVN URL/Working copy (default: `.`).
 - `--reviewer, -r`: `codex`, `gemini`, `copilot`, or `auto` (default: `auto`).
 - `--rev, -v`: A specific revision or commit hash to review.
-- `--last, -n`: Number of latest revisions to review (default: 1).
+- `--last, -n`: Number of latest revisions to review (default: 1). Use negative values (e.g., `-3`) to review only the 3rd commit from the top.
 - `--lang, -l`: Output language (e.g., `zh`, `en`, `auto`).
 - `--prompt, -p`: Additional instructions for the reviewer. Use `@file.txt` to read from a file.
 - `--output, -o`: Report output directory (default: `~/.kodevu`).
@@ -51,6 +39,9 @@ npx kodevu [target] [options]
 - `--debug, -d`: Print debug information.
 - `--version, -V`: Print the current version and exit.
 
+> [!IMPORTANT]
+> `--rev` and `--last` are mutually exclusive. Specifying both will result in an error.
+
 ### Environment Variables
 
 You can set these in your shell to change default behavior without typing flags every time:
@@ -63,17 +54,38 @@ You can set these in your shell to change default behavior without typing flags
 
 ## Examples
 
-**Review with a custom prompt from a file:**
+### Selecting Revisions
+
+Review the **latest 3** commits:
+```bash
+npx kodevu . --last 3
+```
+
+Review **only the 3rd** latest commit:
+```bash
+npx kodevu . --last -3
+```
+
+Review a **specific commit** hash:
+```bash
+npx kodevu . --rev abc1234
+```
+
+### Options & Formatting
+
+Review using **custom instructions** from a file:
 ```bash
 npx kodevu . --prompt @my-rules.txt
 ```
 
-**Generate JSON reports in a local folder:**
+Generate **JSON reports** in a local folder:
 ```bash
-npx kodevu . --format json --output ./review-reports
+npx kodevu . --format json --output ./reports
 ```
 
-**Set a persistent reviewer via ENV:**
+### Environment Variables
+
+Set a **persistent reviewer** for your shell session:
 ```bash
 export KODEVU_REVIEWER=gemini
 npx kodevu .

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodevu",
-  "version": "0.1.44",
+  "version": "0.1.45",
   "license": "MIT",
   "type": "module",
   "description": "Poll SVN revisions or Git commits, send each change diff to a reviewer CLI, and write configurable review reports.",

package/src/config.js

@@ -221,6 +221,10 @@ export async function resolveConfig(cliArgs = {}) {
     }
   }
 
+  if (cliArgs.rev && cliArgs.last) {
+    throw new Error("Parameters --rev and --last are mutually exclusive. Please specify only one.");
+  }
+
   if (!config.target) {
     config.target = process.cwd();
   }