@mrkaran/hodor 0.6.2-rc.4 → 0.6.3-rc.1

package/README.md

@@ -1,5 +1,3 @@
-<a href="https://zerodha.tech"><img src="https://zerodha.tech/static/images/github-badge.svg" align="right" /></a>
-
 # Hodor
 
 > Agentic code reviewer for GitHub PRs, GitLab MRs, Gitea/Forgejo PRs, and local diffs. Powered by the [pi-coding-agent](https://github.com/badlogic/pi-mono) SDK.
@@ -57,6 +55,9 @@ npx @mrkaran/hodor <PR_URL> --model bedrock/converse/anthropic.claude-sonnet-4-5
 # Extended reasoning for complex PRs
 npx @mrkaran/hodor <PR_URL> --reasoning-effort high
 
+# Force a full review of the entire branch (ignore previous incremental reviews)
+npx @mrkaran/hodor <PR_URL> --full
+
 # Custom review instructions
 npx @mrkaran/hodor <PR_URL> --prompt "Focus on SQL injection and auth bypasses"
 
@@ -102,12 +103,16 @@ Local mode:
 | `--model` | `anthropic/claude-sonnet-4-5-20250929` | LLM model as `provider/model-id`. Recommended: Anthropic, OpenAI, Bedrock, OpenRouter. Other pi-ai providers (e.g., Mistral, Gemini, xAI, Groq) are best-effort. See [docs/MODELS.md](./docs/MODELS.md). |
 | `--reasoning-effort` | – | Extended thinking: `low`, `medium`, `high` |
 | `--ultrathink` | Off | Maximum reasoning effort |
+| `--full` | Off | Review the entire source-vs-target diff from scratch, ignoring previous hodor reviews (disables incremental mode) |
+| `--target-branch` | – | Override the target branch to diff against under `--full` (default: the PR/MR's target branch) |
 | `--local` | Off | Review local git changes (no PR URL required) |
 | `--diff-against` | `origin/main` | Git ref to diff against in `--local` mode |
 | `--post` | Off | Post review as a comment on the PR/MR |
 | `--review-style` | `hybrid` | GitLab posting style: `summary`, `inline`, or `hybrid` |
 | `--code-quality` | – | Write a CodeClimate JSON artifact for GitLab code quality reports |
 | `--commit-status` | Off | Post a pass/fail commit status to the GitLab MR head SHA |
+| `--require-delivery` | Off | Exit non-zero if requested comments, statuses, or artifacts are not delivered |
+| `--fail-on-priority` | – | Exit non-zero for findings at or above `P0`, `P1`, `P2`, or `P3` |
 | `--prompt` | – | Append custom instructions to the review prompt |
 | `--prompt-file` | – | Use a custom prompt file |
 | `--workspace` | Temp dir | Workspace directory (reuse for faster multi-PR reviews) |
@@ -160,7 +165,7 @@ hodor "$MR_OR_PR_URL" --prometheus-push "$METRICS_PUSH_URL"
 
 In CI, set `METRICS_PUSH_URL` as a secret/variable and add `--prometheus-push "$METRICS_PUSH_URL"` to the Hodor command. Metrics are best-effort: push failures are logged as warnings and do not fail the review job.
 
-Each metric is labeled with `platform`, `model`, `verdict`, and for PR/MR URLs also `project` (`owner/repo`) and `mr_iid`/PR number. Exported metrics include token usage, cache read/write tokens, cache hit ratio, cost, turns, tool calls, duration, and findings by priority (`P0`–`P3`). A generic Grafana dashboard is available in [`docs/grafana/`](./docs/grafana/).
+Each metric is labeled with `platform`, `model`, `verdict`, `outcome`, and for PR/MR URLs also `project` (`owner/repo`). MR/PR numbers are deliberately excluded to avoid unbounded time-series cardinality. Exported metrics include token usage, cache read/write tokens, cache hit ratio, cost, turns, tool calls, duration, and findings by priority (`P0`–`P3`). A generic Grafana dashboard is available in [`docs/grafana/`](./docs/grafana/).
 
 ### GitHub Actions
 
@@ -226,7 +231,7 @@ See [AUTOMATED_REVIEWS.md](./docs/AUTOMATED_REVIEWS.md) for advanced workflows.
 Hodor automatically optimizes token usage:
 
 - **Diff embedding**: For PRs under 200KB, the diff is embedded directly in the prompt, cutting agent turns from ~60 to ~5.
-- **Incremental reviews**: On re-runs, only reviews changes since the last hodor comment (detected via SHA markers in posted comments).
+- **Incremental reviews**: On re-runs, only reviews changes since the last hodor comment (detected via SHA markers in posted comments). Pass `--full` to override this and re-review the entire source-vs-target diff from scratch.
 - **Compaction**: SDK auto-summarizes older conversation turns when context grows too large.
 
 ## Skills
@@ -257,6 +262,8 @@ Skills are loaded automatically during reviews. See [SKILLS.md](./docs/SKILLS.md
 bun install          # Install dependencies
 bun run build        # Build
 bun run test         # Run tests
+bun run eval:list    # Validate and list review-quality eval cases
+bun run eval -- --model <provider/model> # Execute model evals (uses API credentials)
 bun run dev -- <url> # Run from source
 ```