@krotovm/gitlab-ai-review 1.0.40 → 1.0.41

package/README.md

@@ -2,8 +2,15 @@
 
 # AI Code Reviewer
 
+[![npm](https://img.shields.io/npm/v/@krotovm/gitlab-ai-review)](https://www.npmjs.com/package/@krotovm/gitlab-ai-review)
+[![downloads](https://img.shields.io/npm/dm/@krotovm/gitlab-ai-review)](https://www.npmjs.com/package/@krotovm/gitlab-ai-review)
+[![license](https://img.shields.io/npm/l/@krotovm/gitlab-ai-review)](https://github.com/KrotovM/gitlab-ai-mr-reviewer/blob/main/LICENSE)
+[![GitLab CI/CD Catalog](https://img.shields.io/gitlab/v/release/KrotovM/gitlab-ai-review?label=GitLab%20CI%2FCD%20Catalog&color=fc6d26)](https://gitlab.com/explore/catalog/KrotovM/gitlab-ai-review)
+
 Gitlab AI Code Review is a CLI tool that leverages OpenAI models to automatically review code changes and post a Markdown review to GitLab merge requests from CI.
 
+![AI review comment posted on a GitLab merge request](docs/review.png)
+
 ## Features
 
 - Automatically reviews code changes in GitLab repositories
@@ -30,6 +37,15 @@ ai_review:
     - npx -y @krotovm/gitlab-ai-review
 ```
 
+Or include it as a [CI/CD component from the GitLab Catalog](https://gitlab.com/explore/catalog/KrotovM/gitlab-ai-review) (gitlab.com):
+
+```yaml
+include:
+  - component: gitlab.com/KrotovM/gitlab-ai-review/review@1.0.2
+    inputs:
+      args: "--include-artifacts"
+```
+
 Save debug HTML as a CI artifact:
 
 ```yaml
@@ -48,6 +64,10 @@ ai_review:
       - ai-review-report.html
 ```
 
+The HTML artifact breaks the run down per pass — tokens, durations, triage decisions, per-file findings, and errors:
+
+![AI review debug report artifact](docs/report.png)
+
 ## Env variables
 
 Set these in your project/group CI settings:
@@ -110,3 +130,7 @@ The reviewer uses a three-pass pipeline optimized for large merge requests:
 3. **Consolidate** - Per-file findings are merged, deduplicated, ranked by severity, and trimmed to top N (default 5).
 
 If the triage pass fails (API error, unparseable response), the pipeline falls back to the original single-pass approach automatically.
+
+The pipeline in a CI job log — triage, parallel tool-assisted file reviews, consolidation, verification:
+
+![Multi-pass pipeline in the CI job log](docs/job.png)

package/dist/cli/ci-review.js

@@ -2,7 +2,7 @@
 import OpenAI from "openai";
 import { buildAnswer, buildConsolidatePrompt, buildFileReviewPrompt, buildPrompt, buildTriagePrompt, buildVerificationPrompt, DEFAULT_PROMPT_PROFILE, extractCompletionText, isEmptyReviewBody, NO_FINDINGS_SENTENCE, parseTriageResponseDetailed, parseTriageResponse, } from "../prompt/index.js";
 import { fetchFileAtRef, searchRepository, } from "../gitlab/services.js";
-import { truncateWithMarker } from "../prompt/utils.js";
+import { parseReviewFindings, truncateWithMarker } from "../prompt/utils.js";
 import { logToolUsageMinimal, MAX_FILE_TOOL_ROUNDS, MAX_TOOL_ROUNDS, MAX_VERIFICATION_TOOL_ROUNDS, TOOL_NAME_GET_FILE, TOOL_NAME_GREP, } from "./tooling.js";
 /** Hard deadline per model call, retries included. Must exceed the gateway's own
  *  proxy timeout so the SDK's 5xx retries stay the first line of defense. */
@@ -849,6 +849,22 @@ export async function reviewMergeRequestMultiPass(params) {
     // every final-answer path gets it regardless of model formatting discipline.
     const summaryText = triageResult.summary.trim().replace(/\s*\n\s*/g, " ");
     const withHeader = (body) => `### 🤖 AI Code Review\n\n${summaryText === "" ? "" : `> ${summaryText}\n\n`}${body}`;
+    // Cap transparency: if consolidation likely trimmed the list (final count hit
+    // the cap while per-file review produced more candidates), say so in the note
+    // instead of silently dropping findings.
+    // ponytail: candidates deduped by file+title only; differently-worded dupes
+    // across files still inflate the count, which is why the note says "candidate".
+    const candidateCount = new Set(perFileFindings.flatMap((f) => parseReviewFindings(f.findings).map((x) => `${x.file}|${x.title.toLowerCase()}`))).size;
+    const withCapNote = (body) => {
+        const finalCount = parseReviewFindings(body).length;
+        if (finalCount < maxFindings || candidateCount <= finalCount)
+            return body;
+        const note = `\n\nℹ️ Showing top ${finalCount} of ${candidateCount} candidate findings (\`--max-findings=${maxFindings}\`). Run with \`--include-artifacts\` for the full list.`;
+        const disclaimerAt = body.lastIndexOf("\n\n---\n_");
+        return disclaimerAt === -1
+            ? body + note
+            : body.slice(0, disclaimerAt) + note + body.slice(disclaimerAt);
+    };
     logStep("Pass 3/4: consolidating findings");
     const consolidateMessages = buildConsolidatePrompt({
         perFileFindings,
@@ -875,7 +891,7 @@ export async function reviewMergeRequestMultiPass(params) {
         });
         const consolidatedText = extractCompletionText(consolidateCompletion);
         if (consolidatedText == null || consolidatedText.trim() === "") {
-            return withHeader(buildAnswer(consolidateCompletion));
+            return withHeader(withCapNote(buildAnswer(consolidateCompletion)));
         }
         logStep("Pass 4/4: verifying consolidated findings (repo tools)");
         const verificationMessages = buildVerificationPrompt({
@@ -901,11 +917,11 @@ export async function reviewMergeRequestMultiPass(params) {
                 debugDumpFile,
                 debugRecordWriter,
             });
-            return withHeader(buildAnswer(verificationCompletion));
+            return withHeader(withCapNote(buildAnswer(verificationCompletion)));
         }
         catch (error) {
             logStep(`Verification failed: ${error?.message ?? error}. Returning consolidated findings.`);
-            return withHeader(buildAnswer(consolidateCompletion));
+            return withHeader(withCapNote(buildAnswer(consolidateCompletion)));
         }
     }
     catch (error) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@krotovm/gitlab-ai-review",
-  "version": "1.0.40",
+  "version": "1.0.41",
   "description": "CLI tool to generate AI code reviews for GitLab merge requests.",
   "main": "dist/cli.js",
   "bin": {