open-code-review-toolkit 0.4.0__tar.gz → 0.4.2__tar.gz

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: open-code-review-toolkit
-Version: 0.4.0
+Version: 0.4.2
 Summary: Unofficial GitLab CI integration layer for Open Code Review
 Project-URL: Homepage, https://github.com/xeonvs/open-code-review-toolkit
 Project-URL: Repository, https://github.com/xeonvs/open-code-review-toolkit
@@ -241,7 +241,7 @@ ocr --version
 ocr-ci --help
 ```
 
-The current compatibility target is OCR `1.8.0`. CI should pin the release and verify its published checksum before execution.
+The current compatibility target is OCR `1.8.3`. CI should pin the release and verify its published checksum before execution.
 The [versioned compatibility policy](docs/compatibility.md) records tested assets and evidence and describes the conservative Dependabot-like qualification workflow for later upstream releases.
 Review output defaults to English. `OCR_REVIEW_LANGUAGE` accepts another explicit language name when a project needs localized review output; for example, `OCR_REVIEW_LANGUAGE=Russian`.
 

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/README.md

@@ -15,7 +15,7 @@ ocr --version
 ocr-ci --help
 ```
 
-The current compatibility target is OCR `1.8.0`. CI should pin the release and verify its published checksum before execution.
+The current compatibility target is OCR `1.8.3`. CI should pin the release and verify its published checksum before execution.
 The [versioned compatibility policy](docs/compatibility.md) records tested assets and evidence and describes the conservative Dependabot-like qualification workflow for later upstream releases.
 Review output defaults to English. `OCR_REVIEW_LANGUAGE` accepts another explicit language name when a project needs localized review output; for example, `OCR_REVIEW_LANGUAGE=Russian`.
 

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/pyproject.toml

@@ -124,12 +124,27 @@ underlines = ["", "", ""]
 
 [[tool.towncrier.type]]
 directory = "feature"
-name = "Features"
+name = "🚀 Features"
 showcontent = true
 
 [[tool.towncrier.type]]
 directory = "bugfix"
-name = "Bug fixes"
+name = "🐛 Bug Fixes"
+showcontent = true
+
+[[tool.towncrier.type]]
+directory = "refactor"
+name = "🔧 Refactoring"
+showcontent = true
+
+[[tool.towncrier.type]]
+directory = "doc"
+name = "📖 Documentation"
+showcontent = true
+
+[[tool.towncrier.type]]
+directory = "rules"
+name = "🧩 Rules"
 showcontent = true
 
 [[tool.towncrier.type]]
@@ -138,6 +153,11 @@ name = "Security"
 showcontent = true
 
 [[tool.towncrier.type]]
-directory = "doc"
-name = "Documentation"
+directory = "deprecation"
+name = "Deprecations"
+showcontent = true
+
+[[tool.towncrier.type]]
+directory = "removal"
+name = "Removals"
 showcontent = true

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/src/ocr_toolkit/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.4.0'
-__version_tuple__ = version_tuple = (0, 4, 0)
+__version__ = version = '0.4.2'
+__version_tuple__ = version_tuple = (0, 4, 2)
 
 __commit_id__ = commit_id = None

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/src/ocr_toolkit/posting/formatting.py

@@ -684,7 +684,12 @@ def guide_comment_snippet(comment: dict[str, Any]) -> str:
     return excerpt
 
 
-def format_reviewer_guide(comments: Sequence[dict[str, Any]], omitted_count: int) -> str:
+def format_reviewer_guide(
+    comments: Sequence[dict[str, Any]],
+    omitted_count: int,
+    *,
+    outcome_status: str = "success",
+) -> str:
     """Build a bounded reviewer guide from already published OCR findings."""
 
     if not comments and omitted_count <= 0:
@@ -710,6 +715,10 @@ def format_reviewer_guide(comments: Sequence[dict[str, Any]], omitted_count: int
             f"- Estimated effort to review: {effort}/5",
         ]
     )
+    if outcome_status == "budget_exceeded":
+        lines.append(
+            "- ⚠️ Review scope: OCR reached its token budget; treat all findings as a partial review."
+        )
 
     if not security_comments and omitted_count:
         lines.append(
@@ -772,13 +781,17 @@ def summarize_result(
         "skipped": "ℹ️",  # noqa: RUF001 - intentional information emoji
         "completed_with_warnings": "⚠️",
         "completed_with_errors": "❌",
+        "budget_exceeded": "⚠️",
     }
     marker = f"{status_markers.get(outcome_status, '❌')} " if use_emoji else ""
     safe_message = neutralize_quick_actions(
         compact_control_text(redact_sensitive(outcome_message), max_chars=500)
     )
     if not safe_message:
-        safe_message = f"Found {total} issue(s)." if total else "No issues found."
+        if outcome_status == "budget_exceeded":
+            safe_message = "Review stopped after reaching its token budget; findings are partial."
+        else:
+            safe_message = f"Found {total} issue(s)." if total else "No issues found."
     lines = [
         "# Open Code Review summary",
         f"{marker}{safe_message}",

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/src/ocr_toolkit/posting/workflow.py

@@ -44,7 +44,7 @@ from ocr_toolkit.posting.gitlab import (
     resolve_discussion,
 )
 from ocr_toolkit.posting.markers import annotate_comment_fingerprints
-from ocr_toolkit.posting.result import llm_billing_failure_warnings
+from ocr_toolkit.posting.result import llm_billing_failure_warnings, ocr_warning_text
 from ocr_toolkit.posting.snapshot import (
     BotCommentRefs,
     cleanup_drafts_created_by_this_run,
@@ -392,6 +392,7 @@ def post_results(config: GitLabConfig, result: dict[str, Any]) -> int:
         "skipped",
         "completed_with_warnings",
         "completed_with_errors",
+        "budget_exceeded",
     }
     if status not in allowed_statuses:
         return invalid_ocr_schema_exit(config, "field 'status' is unsupported")
@@ -401,6 +402,14 @@ def post_results(config: GitLabConfig, result: dict[str, Any]) -> int:
         return invalid_ocr_schema_exit(config, "field 'comments' must be a list")
     if not isinstance(warnings_value, list):
         return invalid_ocr_schema_exit(config, "field 'warnings' must be a list")
+    summary_value = result.get("summary")
+    summary_budget_exceeded = (
+        isinstance(summary_value, dict) and summary_value.get("budget_exceeded") is True
+    )
+    if (status == "budget_exceeded") != summary_budget_exceeded:
+        return invalid_ocr_schema_exit(
+            config, "fields 'status' and 'summary.budget_exceeded' disagree"
+        )
 
     comments: list[dict[str, Any]] = []
     for index, comment in enumerate(comments_value):
@@ -455,7 +464,7 @@ def post_results(config: GitLabConfig, result: dict[str, Any]) -> int:
         comments = comments[:publish_limit]
 
     emoji = post_emoji()
-    reviewer_guide = format_reviewer_guide(comments, omitted_count)
+    reviewer_guide = format_reviewer_guide(comments, omitted_count, outcome_status=status)
 
     if publishable_comment_count == 0:
         raw_message = clean_text(result.get("message"))
@@ -472,6 +481,7 @@ def post_results(config: GitLabConfig, result: dict[str, Any]) -> int:
             "skipped": "ℹ️",  # noqa: RUF001 - intentional information emoji
             "completed_with_warnings": "⚠️",
             "completed_with_errors": "❌",
+            "budget_exceeded": "⚠️",
         }[status]
         fallback_message = (
             "No review comments generated. No issues found."
@@ -479,7 +489,11 @@ def post_results(config: GitLabConfig, result: dict[str, Any]) -> int:
             else (
                 "No supported files changed."
                 if status == "skipped"
-                else "Review did not complete cleanly."
+                else (
+                    "Review stopped after reaching its token budget; this is a partial result."
+                    if status == "budget_exceeded"
+                    else "Review did not complete cleanly."
+                )
             )
         )
         body = "# Open Code Review summary\n\n"
@@ -487,7 +501,7 @@ def post_results(config: GitLabConfig, result: dict[str, Any]) -> int:
         body += message or fallback_message
         if warnings:
             warning_lines = [
-                neutralize_quick_actions(redact_sensitive(clean_text(warning)))
+                neutralize_quick_actions(redact_sensitive(ocr_warning_text(warning)))
                 for warning in warnings
             ]
             warning_lines = [warning for warning in warning_lines if warning]

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/src/ocr_toolkit/preflight.py

@@ -24,7 +24,7 @@ DEFAULT_REQUEST_HEADERS = {
     "Accept": "application/json",
     "User-Agent": "open-code-review-ci-preflight/1.0",
 }
-EXPECTED_OCR_VERSION = "1.8.0"
+EXPECTED_OCR_VERSION = "1.8.3"
 
 
 class PreflightError(Exception):

{open_code_review_toolkit-0.4.0 → open_code_review_toolkit-0.4.2}/src/ocr_toolkit/review_runner.py

@@ -84,7 +84,12 @@ def _mcp_usage_receipt(
     """Return bounded MCP usage tied to one validated review-time registry."""
 
     status = payload.get("status")
-    if status not in {"success", "completed_with_warnings", "completed_with_errors"}:
+    if status not in {
+        "success",
+        "completed_with_warnings",
+        "completed_with_errors",
+        "budget_exceeded",
+    }:
         if status == "skipped":
             tool_calls = payload.get("tool_calls")
             by_tool = tool_calls.get("by_tool") if isinstance(tool_calls, dict) else None