kodevu 0.1.43 → 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.43",
+  "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

@@ -161,7 +161,8 @@ export function parseCliArgs(argv) {
     }
 
     if (value === "--last" || value === "-n") {
-      if (!hasNextValue) throw new Error(`Missing value for ${value}`);
+      const hasLastValue = nextValue !== undefined && /^-?\d+$/.test(nextValue);
+      if (!hasLastValue) throw new Error(`Missing value for ${value}`);
       args.last = nextValue;
       index += 1;
       continue;
@@ -220,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();
   }
@@ -258,7 +263,7 @@ export async function resolveConfig(cliArgs = {}) {
   config.last = Number(config.last);
   config.outputFormats = normalizeOutputFormats(config.outputFormats);
 
-  if (!config.rev && (isNaN(config.last) || config.last <= 0)) {
+  if (!config.rev && (isNaN(config.last) || config.last === 0)) {
     config.last = 1;
   }
 
@@ -277,7 +282,7 @@ Options:
   --prompt, -p      Additional instructions or @file.txt to read from file
   --lang, -l        Output language (e.g. zh, en, auto)
   --rev, -v         Review specific revision(s), hashes, branches or ranges (comma-separated)
-  --last, -n        Review the latest N revisions (ignored if --rev is provided) (default: 1)
+  --last, -n        Review the latest N revisions; use negative (-N) to review only the Nth-from-last revision (default: 1)
   --output, -o      Output directory (default: ~/.kodevu)
   --format, -f      Output formats (markdown, json, comma-separated)
   --debug, -d       Print extra debug information

package/src/review-runner.js

@@ -159,6 +159,9 @@ export async function runReviewCycle(config) {
 
   if (config.rev) {
     changeIdsToReview = await backend.resolveChangeIds(config, targetInfo, config.rev);
+  } else if (config.last < 0) {
+    const candidates = await backend.getLatestChangeIds(config, targetInfo, Math.abs(config.last));
+    changeIdsToReview = candidates.length > 0 ? [candidates[0]] : [];
   } else {
     changeIdsToReview = await backend.getLatestChangeIds(config, targetInfo, config.last || 1);
   }