kodevu 0.1.54 → 0.1.55

package/README.md

@@ -1,5 +1,7 @@
 # Kodevu
 
+> The name **Kodevu** is a phonetic play on "code review".
+
 A Node.js tool that fetches Git commits or SVN revisions, sends the diff to a supported AI reviewer CLI, and writes review results to report files.
 
 ## Pure & Zero Config
@@ -127,13 +129,6 @@ npx kodevu . \
   --openai-model gpt-5-mini
 ```
 
-## How it Works
-
-- **Git Targets**: `target` must be a local repository or subdirectory.
-- **SVN Targets**: `target` can be a working copy path or repository URL.
-- **Reviewer "auto"**: Probes `codex`, `gemini`, and `copilot` in your `PATH` and selects one.
-- **Reviewer "openai"**: Calls the OpenAI Chat Completions API directly. `auto` does not select `openai`, so API-based use stays explicit.
-- **Contextual Review**: For local repositories, the reviewer can inspect related files beyond the diff to provide deeper insights.
 
 ## License
 

package/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: kodevu
-description: A tool to fetch Git commits or SVN revisions, send the diff to a supported AI reviewer CLI, and write configurable review reports.
+description: A tool to fetch Git/SVN diffs, send them to an AI reviewer, and generate configurable code review reports.
 ---
 
 # Kodevu Skill
 
-Kodevu is a Node.js tool that fetches Git commits or SVN revisions, sends the diff to a supported AI reviewer CLI, and writes review results to report files.
+Kodevu is a Node.js tool that fetches Git commits or SVN revisions, sends the diff to a supported AI reviewer CLI, and writes review results to report files. It is designed to be **stateless** and requires **no configuration files**.
 
 ## Usage
 
-Use `npx kodevu` to review a codebase. It is designed to be stateless and requires no configuration files.
+Use `npx kodevu` to review a codebase.
 
 ### Reviewing the latest commit
 
@@ -29,13 +29,19 @@ npx kodevu . --rev <commit-hash>
 npx kodevu . --last 3
 ```
 
+### Reviewing uncommitted changes
+
+```bash
+npx kodevu . --uncommitted
+```
+
 ### Supported Reviewers
 
-`kodevu` supports several AI reviewer CLIs: `auto`, `openai`, `gemini`, `codex`, `copilot`. The default is `auto`. Use the `--reviewer` option to override.
+`kodevu` supports several AI reviewer backends: `auto`, `openai`, `gemini`, `codex`, `copilot`. The default is `auto`, which probes available CLI tools in your `PATH`.
 
 Example using OpenAI:
 ```bash
-npx kodevu . --reviewer openai --openai-api-key <YOUR_API_KEY> --openai-model gpt-4o
+npx kodevu . --reviewer openai --openai-api-key <YOUR_API_KEY> --openai-model gpt-5-mini
 ```
 
 ### Generating JSON Reports
@@ -45,19 +51,31 @@ By default, review reports are generated as Markdown files in `~/.kodevu/`. You
 npx kodevu . --format json --output ./reports
 ```
 
-### Formatting the Prompt
+### Custom Prompts
 
-You can provide clear instructions to the reviewer using `--prompt`:
+You can provide additional instructions to the reviewer using `--prompt`:
 ```bash
 npx kodevu . --prompt "Focus on security issues and suggest optimizations."
 ```
 Or from a file: `--prompt @my-rules.txt`
 
+### Environment Variables
+
+All options can also be set via environment variables to avoid repetitive flags:
+
+- `KODEVU_REVIEWER` – Default reviewer.
+- `KODEVU_LANG` – Default output language.
+- `KODEVU_OUTPUT_DIR` – Default output directory.
+- `KODEVU_PROMPT` – Default prompt instructions.
+- `KODEVU_OPENAI_API_KEY` – API key for `openai`.
+- `KODEVU_OPENAI_BASE_URL` – Base URL for `openai`.
+- `KODEVU_OPENAI_MODEL` – Model for `openai`.
+
 ## Working with Target Repositories
 
-- `target`: Repository path (Git) or SVN URL/Working copy (default: `.`).
+- **Git**: `target` must be a local repository or subdirectory.
+- **SVN**: `target` can be a working copy path or repository URL.
 
-For example, to run on a specific path, you can use:
 ```bash
 npx kodevu /path/to/project --last 1
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodevu",
-  "version": "0.1.54",
+  "version": "0.1.55",
   "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/utils.js

@@ -50,9 +50,10 @@ export function formatDate(dateInput) {
   const hours = pad(d.getHours());
   const minutes = pad(d.getMinutes());
   const seconds = pad(d.getSeconds());
+  const milliseconds = String(d.getMilliseconds()).padStart(3, "0");
   const offset = `${sign}${pad(offsetHours)}:${pad(offsetMins)}`;
 
-  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds} ${offset}`;
+  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${milliseconds} ${offset}`;
 }
 export function getTimestampPrefix() {
   const now = new Date();