open-code-review-toolkit 0.14.6__tar.gz → 0.14.8__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (187) hide show
  1. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/PKG-INFO +2 -2
  2. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/README.md +1 -1
  3. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/_version.py +2 -2
  4. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/cli.py +7 -1
  5. open_code_review_toolkit-0.14.8/src/ocr_toolkit/common/provider_http.py +25 -0
  6. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/configure.py +4 -0
  7. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/collector.py +29 -7
  8. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/contracts.py +143 -102
  9. open_code_review_toolkit-0.14.8/src/ocr_toolkit/diagrams/diagnostics.py +131 -0
  10. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/lifecycle.py +11 -3
  11. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/mcp.py +38 -44
  12. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/project.py +12 -8
  13. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/native_capabilities.py +14 -1
  14. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/gitlab.py +40 -4
  15. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/preflight.py +47 -6
  16. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/provider_config.py +38 -3
  17. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab.py +32 -3
  18. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_ci.py +22 -3
  19. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_discussions.py +19 -3
  20. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_debug.py +38 -1
  21. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_runner.py +13 -1
  22. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_trace.py +32 -1
  23. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/.gitignore +0 -0
  24. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/LICENSE +0 -0
  25. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/pyproject.toml +0 -0
  26. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/__init__.py +0 -0
  27. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/__init__.py +0 -0
  28. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/filesystem.py +0 -0
  29. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/git.py +0 -0
  30. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/language.py +0 -0
  31. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/literal_context.py +0 -0
  32. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/markdown.py +0 -0
  33. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/redaction.py +0 -0
  34. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/value_boundaries.py +0 -0
  35. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/config_writer.py +0 -0
  36. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/__init__.py +0 -0
  37. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/broker.py +0 -0
  38. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/ci_outcomes.py +0 -0
  39. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/code_text.py +0 -0
  40. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/contracts.py +0 -0
  41. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/__init__.py +0 -0
  42. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/admission.py +0 -0
  43. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/credentials.py +0 -0
  44. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/datetimes.py +0 -0
  45. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/decoding.py +0 -0
  46. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/email.py +0 -0
  47. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/markup.py +0 -0
  48. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/numeric.py +0 -0
  49. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/presentation.py +0 -0
  50. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/projection.py +0 -0
  51. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/result_prose.py +0 -0
  52. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/mcp.py +0 -0
  53. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/policy.py +0 -0
  54. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/recognizers.py +0 -0
  55. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/store.py +0 -0
  56. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/__init__.py +0 -0
  57. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/admission.py +0 -0
  58. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/persistence.py +0 -0
  59. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/sources.py +0 -0
  60. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/__init__.py +0 -0
  61. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/__main__.py +0 -0
  62. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/cli.py +0 -0
  63. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/corpus.py +0 -0
  64. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/limits.py +0 -0
  65. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/proof.py +0 -0
  66. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/report.py +0 -0
  67. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/scanner.py +0 -0
  68. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/state.py +0 -0
  69. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/worker_process.py +0 -0
  70. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/__init__.py +0 -0
  71. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/__main__.py +0 -0
  72. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/actions.py +0 -0
  73. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/artifacts.py +0 -0
  74. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/categorize.py +0 -0
  75. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collect.py +0 -0
  76. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/__init__.py +0 -0
  77. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/graphs.py +0 -0
  78. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/orchestration.py +0 -0
  79. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/projections.py +0 -0
  80. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/registry.py +0 -0
  81. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/sources.py +0 -0
  82. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/coverage.py +0 -0
  83. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/__init__.py +0 -0
  84. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/ansible/__init__.py +0 -0
  85. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/ansible/requirements.py +0 -0
  86. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/ansible/topology.py +0 -0
  87. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/contracts.py +0 -0
  88. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/go.py +0 -0
  89. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/javascript.py +0 -0
  90. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/php.py +0 -0
  91. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/python.py +0 -0
  92. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/__init__.py +0 -0
  93. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/contracts.py +0 -0
  94. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/detection.py +0 -0
  95. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/__init__.py +0 -0
  96. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/frontend.py +0 -0
  97. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/go.py +0 -0
  98. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/php.py +0 -0
  99. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/python.py +0 -0
  100. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/registry.py +0 -0
  101. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/schema.py +0 -0
  102. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/templates.py +0 -0
  103. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/gitlink_projection.py +0 -0
  104. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/gitlinks.py +0 -0
  105. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/infrastructure.py +0 -0
  106. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/invocation.py +0 -0
  107. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/mcp.py +0 -0
  108. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/model.py +0 -0
  109. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/opaque_code.py +0 -0
  110. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/__init__.py +0 -0
  111. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/contracts.py +0 -0
  112. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/decisions.py +0 -0
  113. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/guidance.py +0 -0
  114. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/registry.py +0 -0
  115. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/schema.py +0 -0
  116. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/scopes.py +0 -0
  117. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/repository.py +0 -0
  118. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/review_context.py +0 -0
  119. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/review_range.py +0 -0
  120. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/source_reader.py +0 -0
  121. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/source_syntax.py +0 -0
  122. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/__init__.py +0 -0
  123. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/atomic.py +0 -0
  124. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/contracts.py +0 -0
  125. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/core.py +0 -0
  126. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/readback.py +0 -0
  127. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/values.py +0 -0
  128. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/text_contracts.py +0 -0
  129. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/text_excerpts.py +0 -0
  130. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/text_metadata.py +0 -0
  131. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/__init__.py +0 -0
  132. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/admission.py +0 -0
  133. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/contracts.py +0 -0
  134. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/gateway.py +0 -0
  135. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/registry.py +0 -0
  136. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/relay.py +0 -0
  137. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/runtime.py +0 -0
  138. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/transport.py +0 -0
  139. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/local_chatgpt.py +0 -0
  140. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/mcp_config.py +0 -0
  141. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/ocr_result.py +0 -0
  142. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/__init__.py +0 -0
  143. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/__main__.py +0 -0
  144. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/approval.py +0 -0
  145. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/comments.py +0 -0
  146. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/formatting.py +0 -0
  147. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/freshness.py +0 -0
  148. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/gitlab_approval.py +0 -0
  149. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/markers.py +0 -0
  150. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/payloads.py +0 -0
  151. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/reconciliation.py +0 -0
  152. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/result.py +0 -0
  153. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/settings.py +0 -0
  154. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/snapshot.py +0 -0
  155. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/source_suggestions.py +0 -0
  156. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/suggestions.py +0 -0
  157. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/transaction.py +0 -0
  158. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/workflow.py +0 -0
  159. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/pre_execution.py +0 -0
  160. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/provider_failure.py +0 -0
  161. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/__init__.py +0 -0
  162. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_context.py +0 -0
  163. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_identity.py +0 -0
  164. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_remediation.py +0 -0
  165. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/local.py +0 -0
  166. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/local_config.py +0 -0
  167. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/py.typed +0 -0
  168. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/__init__.py +0 -0
  169. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/diagram.py +0 -0
  170. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/diagram_layout.py +0 -0
  171. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/dlp.py +0 -0
  172. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/federation.py +0 -0
  173. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/metadata.py +0 -0
  174. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/model.py +0 -0
  175. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/outcome.py +0 -0
  176. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/result.py +0 -0
  177. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/sections.py +0 -0
  178. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/text.py +0 -0
  179. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/usage.py +0 -0
  180. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/warnings.py +0 -0
  181. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/repository_coverage.py +0 -0
  182. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/result_contract.py +0 -0
  183. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/result_usage.py +0 -0
  184. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_identity.py +0 -0
  185. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_progress.py +0 -0
  186. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_range.py +0 -0
  187. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_receipt.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: open-code-review-toolkit
3
- Version: 0.14.6
3
+ Version: 0.14.8
4
4
  Summary: Unofficial GitLab CI integration layer for Open Code Review
5
5
  Project-URL: Homepage, https://github.com/xeonvs/open-code-review-toolkit
6
6
  Project-URL: Repository, https://github.com/xeonvs/open-code-review-toolkit
@@ -339,7 +339,7 @@ coverage partial. It leaves the pointer and submodule contents unreviewed,
339
339
  preserves prior finding threads and cannot automatically approve. A diff with
340
340
  no selected ordinary files starts no model review and posts an advisory status.
341
341
 
342
- After every current review note publishes, the GitLab adapter can add a conservative approval bound to receipt v11's exact reviewed diff, actual target, policy authority, merge-request author, DLP mode, and reconciled federation use. This write is enabled by default; set `OCR_AUTO_APPROVE=false` when the bot must remain comment-only. DLP-clean metadata, generic discussions, protected same-revision CI outcomes, unused governed services, and successful `review_read` tool use do not independently block approval. An unprotected target, disabled DLP, degraded metadata, a DLP rejection, required context degradation, admitted remediation history, older receipts, publication filtering, used advisory tools, uncertain federation accounting, author movement, or bot self-authorship prevents an approval write. A CI status is review context, never approval authority. GitLab approval rules, Code Owners, and protected-branch policy remain authoritative merge policy. They are not prerequisites for OCR execution. The toolkit only adds an eligible approval; it never removes an existing approval when a later review is ineligible or disabled.
342
+ After every current review note publishes, the GitLab adapter can add a conservative approval bound to the current receipt's exact reviewed diff, actual target, policy authority, merge-request author, DLP mode, and reconciled federation use. This write is enabled by default; set `OCR_AUTO_APPROVE=false` when the bot must remain comment-only. DLP-clean metadata, generic discussions, protected same-revision CI outcomes, unused governed services, and successful `review_read` tool use do not independently block approval. An unprotected target, disabled DLP, degraded metadata, a DLP rejection, required context degradation, admitted remediation history, older receipts, publication filtering, used advisory tools, uncertain federation accounting, author movement, or bot self-authorship prevents an approval write. A CI status is review context, never approval authority. GitLab approval rules, Code Owners, and protected-branch policy remain authoritative merge policy. They are not prerequisites for OCR execution. The toolkit only adds an eligible approval; it never removes an existing approval when a later review is ineligible or disabled.
343
343
 
344
344
  An intentionally absent toolkit receipt retains compatible direct posting outside
345
345
  GitLab CI without automatic approval. A present v9/v10 receipt can be read for historical
@@ -101,7 +101,7 @@ coverage partial. It leaves the pointer and submodule contents unreviewed,
101
101
  preserves prior finding threads and cannot automatically approve. A diff with
102
102
  no selected ordinary files starts no model review and posts an advisory status.
103
103
 
104
- After every current review note publishes, the GitLab adapter can add a conservative approval bound to receipt v11's exact reviewed diff, actual target, policy authority, merge-request author, DLP mode, and reconciled federation use. This write is enabled by default; set `OCR_AUTO_APPROVE=false` when the bot must remain comment-only. DLP-clean metadata, generic discussions, protected same-revision CI outcomes, unused governed services, and successful `review_read` tool use do not independently block approval. An unprotected target, disabled DLP, degraded metadata, a DLP rejection, required context degradation, admitted remediation history, older receipts, publication filtering, used advisory tools, uncertain federation accounting, author movement, or bot self-authorship prevents an approval write. A CI status is review context, never approval authority. GitLab approval rules, Code Owners, and protected-branch policy remain authoritative merge policy. They are not prerequisites for OCR execution. The toolkit only adds an eligible approval; it never removes an existing approval when a later review is ineligible or disabled.
104
+ After every current review note publishes, the GitLab adapter can add a conservative approval bound to the current receipt's exact reviewed diff, actual target, policy authority, merge-request author, DLP mode, and reconciled federation use. This write is enabled by default; set `OCR_AUTO_APPROVE=false` when the bot must remain comment-only. DLP-clean metadata, generic discussions, protected same-revision CI outcomes, unused governed services, and successful `review_read` tool use do not independently block approval. An unprotected target, disabled DLP, degraded metadata, a DLP rejection, required context degradation, admitted remediation history, older receipts, publication filtering, used advisory tools, uncertain federation accounting, author movement, or bot self-authorship prevents an approval write. A CI status is review context, never approval authority. GitLab approval rules, Code Owners, and protected-branch policy remain authoritative merge policy. They are not prerequisites for OCR execution. The toolkit only adds an eligible approval; it never removes an existing approval when a later review is ineligible or disabled.
105
105
 
106
106
  An intentionally absent toolkit receipt retains compatible direct posting outside
107
107
  GitLab CI without automatic approval. A present v9/v10 receipt can be read for historical
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '0.14.6'
22
- __version_tuple__ = version_tuple = (0, 14, 6)
21
+ __version__ = version = '0.14.8'
22
+ __version_tuple__ = version_tuple = (0, 14, 8)
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -44,7 +44,13 @@ def build_parser() -> argparse.ArgumentParser:
44
44
  subparsers.add_parser("configure", help="Write the OCR runtime configuration.")
45
45
  subparsers.add_parser("mcp-config", help="Write OCR MCP server configuration.")
46
46
  review_parser = subparsers.add_parser(
47
- "review", help="Run OCR with private artifacts and safe failure diagnostics."
47
+ "review",
48
+ help="Run OCR with private artifacts and safe failure diagnostics.",
49
+ epilog=(
50
+ "Diagrams: OCR_REVIEW_DIAGRAM_MODE=local requests a standalone private diagram; "
51
+ "unset/on, off and spoiler do not request one with --local. "
52
+ "GitLab on/spoiler request expanded/collapsed output; off disables it."
53
+ ),
48
54
  )
49
55
  review_parser.add_argument("--result", required=True, help="OCR JSON output path.")
50
56
  review_parser.add_argument("--stderr", required=True, help="Full OCR stderr artifact path.")
@@ -0,0 +1,25 @@
1
+ """Small provider-neutral policy for outbound forge API request identity."""
2
+
3
+ from collections.abc import Mapping
4
+
5
+ DEFAULT_FORGE_API_USER_AGENT = "open-code-review-toolkit-provider/1"
6
+ FORGE_API_USER_AGENT_VARIABLE = "OCR_FORGE_API_USER_AGENT"
7
+ _UNSET = object()
8
+
9
+
10
+ def resolve_forge_api_user_agent(environment: Mapping[str, str]) -> str:
11
+ """Resolve a bounded printable ASCII agent without exposing invalid input."""
12
+
13
+ value = environment.get(FORGE_API_USER_AGENT_VARIABLE, _UNSET)
14
+ if value is _UNSET:
15
+ return DEFAULT_FORGE_API_USER_AGENT
16
+ if (
17
+ not isinstance(value, str)
18
+ or not 1 <= len(value) <= 256
19
+ or any(not 32 <= ord(character) <= 126 for character in value)
20
+ or not value.strip()
21
+ ):
22
+ raise ValueError(
23
+ f"{FORGE_API_USER_AGENT_VARIABLE} must be nonblank printable ASCII (1-256 bytes)"
24
+ )
25
+ return value
@@ -13,6 +13,7 @@ from ocr_toolkit.local_chatgpt import LocalChatGPTError, auth_mode, provider_ent
13
13
  from ocr_toolkit.provider_config import (
14
14
  ProviderConfigError,
15
15
  provider_config_from_environment,
16
+ provider_url_notice,
16
17
  )
17
18
 
18
19
 
@@ -74,6 +75,9 @@ def build_config_updates(*, local: bool = False) -> dict[str, Any]:
74
75
  updates["llm.extra_headers"] = request_controls.extra_headers
75
76
  if request_controls.extra_body is not None:
76
77
  updates["llm.extra_body"] = request_controls.extra_body
78
+ notice = provider_url_notice(provider)
79
+ if notice:
80
+ print(f"WARNING: {redact_sensitive(notice)}", file=sys.stderr)
77
81
  except (ProviderConfigError, LocalChatGPTError) as exc:
78
82
  raise OCRRuntimeConfigError(str(exc)) from exc
79
83
 
@@ -31,10 +31,11 @@ from ocr_toolkit.diagrams.contracts import (
31
31
  parse_submission,
32
32
  submission_payload,
33
33
  )
34
+ from ocr_toolkit.diagrams.diagnostics import MAX_DIAGNOSTIC_BYTES, parse_diagnostic
34
35
  from ocr_toolkit.review_range import ReviewRange
35
36
 
36
- COLLECTOR_SCHEMA = "ocr.diagram-collector/v1"
37
- MAX_COLLECTOR_BYTES = MAX_DIAGRAM_BYTES + 1024
37
+ COLLECTOR_SCHEMA = "ocr.diagram-collector/v2"
38
+ MAX_COLLECTOR_BYTES = MAX_DIAGRAM_BYTES + MAX_DIAGNOSTIC_BYTES + 1024
38
39
  _COLLECTOR_KEYS = {
39
40
  "schema",
40
41
  "run_id",
@@ -44,6 +45,7 @@ _COLLECTOR_KEYS = {
44
45
  "input_bytes",
45
46
  "reason",
46
47
  "candidate",
48
+ "last_error",
47
49
  }
48
50
 
49
51
 
@@ -55,6 +57,17 @@ class CollectorSnapshot:
55
57
  input_bytes: int
56
58
  reason: DiagramReason
57
59
  candidate: DiagramSubmission | None
60
+ last_error: dict[str, object] | None = None
61
+
62
+ @property
63
+ def retryable(self) -> bool:
64
+ """Only model validation can be repaired within the remaining run budget."""
65
+
66
+ return (
67
+ self.reason in {"none", "invalid"}
68
+ and self.submissions < MAX_SUBMISSIONS
69
+ and self.input_bytes < MAX_SUBMISSION_BYTES
70
+ )
58
71
 
59
72
 
60
73
  @dataclass(frozen=True, slots=True)
@@ -174,7 +187,12 @@ class DiagramCollector:
174
187
  )
175
188
  if (parsed is not None) != (count > 0 and reason == "none"):
176
189
  raise DiagramError("diagram collector candidate state is inconsistent")
177
- return CollectorSnapshot(count, size, cast(DiagramReason, reason), parsed)
190
+ error = parse_diagnostic(value["last_error"]) if value["last_error"] is not None else None
191
+ if (reason == "invalid" and error is None) or (
192
+ error is not None and (count == 0 or reason in {"conflict", "budget"})
193
+ ):
194
+ raise DiagramError("diagram collector diagnostic state is inconsistent")
195
+ return CollectorSnapshot(count, size, cast(DiagramReason, reason), parsed, error)
178
196
 
179
197
  def read(self) -> CollectorSnapshot:
180
198
  """Take a serialized hostile-read snapshot before any cleanup occurs."""
@@ -194,6 +212,7 @@ class DiagramCollector:
194
212
  "candidate": submission_payload(snapshot.candidate)
195
213
  if snapshot.candidate is not None
196
214
  else None,
215
+ "last_error": snapshot.last_error,
197
216
  }
198
217
  encoded = bounded_json(payload, limit=MAX_COLLECTOR_BYTES)
199
218
  temporary = f".{name}.{secrets.token_hex(8)}"
@@ -248,20 +267,23 @@ class DiagramCollector:
248
267
  total = min(previous.input_bytes + max(1, size), MAX_SUBMISSION_BYTES + 1)
249
268
  reason = previous.reason
250
269
  candidate = previous.candidate
270
+ error = None
251
271
  if count > MAX_SUBMISSIONS or total > MAX_SUBMISSION_BYTES:
252
272
  reason = "budget"
253
- elif reason == "none":
273
+ elif reason in {"none", "invalid"}:
254
274
  try:
255
275
  parsed = parse_submission(value, expected_range=self.review_range)
256
- except DiagramError:
257
- reason = "invalid"
276
+ except DiagramError as exc:
277
+ error = exc.diagnostic()
278
+ reason = "none" if candidate is not None else "invalid"
258
279
  else:
259
280
  if candidate is not None and candidate != parsed:
260
281
  reason = "conflict"
261
282
  else:
262
283
  candidate = parsed
284
+ reason = "none"
263
285
  snapshot = CollectorSnapshot(
264
- count, total, reason, candidate if reason == "none" else None
286
+ count, total, reason, candidate if reason == "none" else None, error
265
287
  )
266
288
  self._write(parent, name, snapshot)
267
289
  return snapshot
@@ -5,9 +5,12 @@ from __future__ import annotations
5
5
  import json
6
6
  import re
7
7
  import unicodedata
8
+ from collections.abc import Callable
8
9
  from dataclasses import dataclass
9
10
  from typing import Literal, cast
10
11
 
12
+ from ocr_toolkit.diagrams.diagnostics import DiagramError as DiagramError
13
+ from ocr_toolkit.diagrams.diagnostics import at_pointer
11
14
  from ocr_toolkit.result_contract import OcrResultContractError
12
15
  from ocr_toolkit.review_range import ReviewRange
13
16
 
@@ -26,10 +29,6 @@ DiagramReason = Literal[
26
29
  ]
27
30
 
28
31
 
29
- class DiagramError(ValueError):
30
- """A candidate violates the closed optional diagram contract."""
31
-
32
-
33
32
  def parse_diagram_mode(raw: str | None, *, local: bool) -> DiagramMode:
34
33
  """Resolve unset/default separately from explicit blank or unsupported values."""
35
34
 
@@ -146,10 +145,19 @@ class DiagramResult:
146
145
 
147
146
  def _object(value: object, keys: set[str]) -> dict[str, object]:
148
147
  if not isinstance(value, dict) or set(value) != keys:
149
- raise DiagramError("diagram object has an invalid closed shape")
148
+ raise DiagramError(
149
+ "diagram object has an invalid closed shape", allowed=tuple(sorted(keys))
150
+ )
150
151
  return value
151
152
 
152
153
 
154
+ def _field[T](raw: dict[str, object], key: str, reader: Callable[[object], T]) -> T:
155
+ """Locate a value failure under a known canonical property."""
156
+
157
+ with at_pointer("/" + key):
158
+ return reader(raw[key])
159
+
160
+
153
161
  def _array(value: object, minimum: int, maximum: int) -> list[object]:
154
162
  if not isinstance(value, list) or not minimum <= len(value) <= maximum:
155
163
  raise DiagramError("diagram array exceeds its item budget")
@@ -180,19 +188,22 @@ def _identifier(value: object) -> str:
180
188
 
181
189
  def _references(value: object, *, required: bool = True) -> tuple[SourceReference, ...]:
182
190
  references = []
183
- for item in _array(value, 1 if required else 0, 2):
184
- raw = _object(item, {"path", "start_line", "end_line"})
185
- path = _text(raw["path"], path=True)
186
- if (
187
- path.startswith(("/", "-"))
188
- or "\\" in path
189
- or any(part in {"", ".", ".."} for part in path.split("/"))
190
- ):
191
- raise DiagramError("diagram source path is not normalized and relative")
192
- start, end = raw["start_line"], raw["end_line"]
193
- if type(start) is not int or type(end) is not int or not 1 <= start <= end <= 1_000_000:
194
- raise DiagramError("diagram source span is invalid")
195
- references.append(SourceReference(path, start, end))
191
+ for item_index, item in enumerate(_array(value, 1 if required else 0, 2)):
192
+ with at_pointer(f"/{item_index}"):
193
+ raw = _object(item, {"path", "start_line", "end_line"})
194
+ path = _field(raw, "path", lambda v: _text(v, path=True))
195
+ if (
196
+ path.startswith(("/", "-"))
197
+ or "\\" in path
198
+ or any(part in {"", ".", ".."} for part in path.split("/"))
199
+ ):
200
+ raise DiagramError(
201
+ "diagram source path is not normalized and relative", path="/path"
202
+ )
203
+ start, end = raw["start_line"], raw["end_line"]
204
+ if type(start) is not int or type(end) is not int or not 1 <= start <= end <= 1_000_000:
205
+ raise DiagramError("diagram source span is invalid")
206
+ references.append(SourceReference(path, start, end))
196
207
  if len(set(references)) != len(references):
197
208
  raise DiagramError("diagram source references are duplicated")
198
209
  return tuple(sorted(references))
@@ -208,35 +219,47 @@ def _unique_ids(values: tuple[FlowNode, ...] | tuple[Participant, ...]) -> set[s
208
219
  def _flowchart(value: dict[str, object]) -> Flowchart:
209
220
  raw = _object(value, {"kind", "nodes", "edges"})
210
221
  nodes = []
211
- for item in _array(raw["nodes"], 1, 12):
212
- node = _object(item, {"id", "kind", "label", "references"})
213
- kind = node["kind"]
214
- if kind not in ("step", "decision"):
215
- raise DiagramError("diagram node kind is invalid")
216
- nodes.append(
217
- FlowNode(
218
- _identifier(node["id"]),
219
- kind,
220
- _text(node["label"]),
221
- _references(node["references"]),
222
+ for item_index, item in enumerate(_field(raw, "nodes", lambda v: _array(v, 1, 12))):
223
+ with at_pointer(f"/nodes/{item_index}"):
224
+ node = _object(item, {"id", "kind", "label", "references"})
225
+ kind = node["kind"]
226
+ if kind not in ("step", "decision"):
227
+ raise DiagramError("diagram node kind is invalid", path="/kind")
228
+ nodes.append(
229
+ FlowNode(
230
+ _field(node, "id", _identifier),
231
+ kind,
232
+ _field(node, "label", _text),
233
+ _field(node, "references", _references),
234
+ )
222
235
  )
223
- )
224
236
  normalized_nodes = tuple(sorted(nodes, key=lambda node: node.identifier))
225
- identifiers = _unique_ids(normalized_nodes)
237
+ with at_pointer("/nodes"):
238
+ identifiers = _unique_ids(normalized_nodes)
226
239
  edges = []
227
- for item in _array(raw["edges"], 0, 16):
228
- edge = _object(item, {"source", "target", "condition", "references"})
229
- source, target = _identifier(edge["source"]), _identifier(edge["target"])
230
- if source not in identifiers or target not in identifiers:
231
- raise DiagramError("diagram edge has an unknown endpoint")
232
- condition = _text(edge["condition"], empty=True)
233
- edges.append(
234
- FlowEdge(
235
- source, target, condition, _references(edge["references"], required=bool(condition))
240
+ for item_index, item in enumerate(_field(raw, "edges", lambda v: _array(v, 0, 16))):
241
+ with at_pointer(f"/edges/{item_index}"):
242
+ edge = _object(item, {"source", "target", "condition", "references"})
243
+ source, target = (
244
+ _field(edge, "source", _identifier),
245
+ _field(edge, "target", _identifier),
246
+ )
247
+ if source not in identifiers or target not in identifiers:
248
+ raise DiagramError(
249
+ "diagram edge has an unknown endpoint",
250
+ path="/source" if source not in identifiers else "/target",
251
+ )
252
+ condition = _field(edge, "condition", lambda v: _text(v, empty=True))
253
+ edges.append(
254
+ FlowEdge(
255
+ source,
256
+ target,
257
+ condition,
258
+ _field(edge, "references", lambda v: _references(v, required=bool(condition))),
259
+ )
236
260
  )
237
- )
238
261
  if len(set(edges)) != len(edges):
239
- raise DiagramError("diagram edges are duplicated")
262
+ raise DiagramError("diagram edges are duplicated", path="/edges")
240
263
  return Flowchart(
241
264
  normalized_nodes,
242
265
  tuple(
@@ -250,72 +273,86 @@ def _flowchart(value: dict[str, object]) -> Flowchart:
250
273
  def _sequence(value: dict[str, object]) -> SequenceDiagram:
251
274
  raw = _object(value, {"kind", "participants", "steps"})
252
275
  participants = []
253
- for item in _array(raw["participants"], 1, 8):
254
- participant = _object(item, {"id", "label", "references"})
255
- participants.append(
256
- Participant(
257
- _identifier(participant["id"]),
258
- _text(participant["label"]),
259
- _references(participant["references"]),
276
+ for item_index, item in enumerate(_field(raw, "participants", lambda v: _array(v, 1, 8))):
277
+ with at_pointer(f"/participants/{item_index}"):
278
+ participant = _object(item, {"id", "label", "references"})
279
+ participants.append(
280
+ Participant(
281
+ _field(participant, "id", _identifier),
282
+ _field(participant, "label", _text),
283
+ _field(participant, "references", _references),
284
+ )
260
285
  )
261
- )
262
286
  normalized_participants = tuple(
263
287
  sorted(participants, key=lambda participant: participant.identifier)
264
288
  )
265
- identifiers = _unique_ids(normalized_participants)
289
+ with at_pointer("/participants"):
290
+ identifiers = _unique_ids(normalized_participants)
266
291
  messages, alternatives = 0, 0
267
292
 
268
293
  def parse_steps(value: object, depth: int) -> tuple[SequenceStep, ...]:
269
294
  nonlocal messages, alternatives
270
295
  steps: list[SequenceStep] = []
271
- for item in _array(value, 0, 20):
272
- if not isinstance(item, dict):
273
- raise DiagramError("diagram sequence step must be an object")
274
- if item.get("kind") == "message":
275
- message = _object(
276
- item, {"kind", "source", "target", "message_type", "label", "references"}
277
- )
278
- source, target = _identifier(message["source"]), _identifier(message["target"])
279
- message_type = message["message_type"]
280
- if source not in identifiers or target not in identifiers:
281
- raise DiagramError("diagram message has an unknown endpoint")
282
- if message_type not in ("call", "return"):
283
- raise DiagramError("diagram message type is invalid")
284
- messages += 1
285
- if messages > 16:
286
- raise DiagramError("diagram exceeds its total message budget")
287
- steps.append(
288
- SequenceMessage(
289
- source,
290
- target,
291
- message_type,
292
- _text(message["label"]),
293
- _references(message["references"]),
296
+ for item_index, item in enumerate(_array(value, 0, 20)):
297
+ with at_pointer(f"/{item_index}"):
298
+ if not isinstance(item, dict):
299
+ raise DiagramError("diagram sequence step must be an object")
300
+ if item.get("kind") == "message":
301
+ message = _object(
302
+ item, {"kind", "source", "target", "message_type", "label", "references"}
294
303
  )
295
- )
296
- elif item.get("kind") == "alt":
297
- alternative = _object(item, {"kind", "branches"})
298
- alternatives += 1
299
- if alternatives > 4 or depth >= 2:
300
- raise DiagramError("diagram exceeds its total alternative or nesting budget")
301
- branches = []
302
- for branch_item in _array(alternative["branches"], 2, 2):
303
- branch = _object(branch_item, {"condition", "references", "steps"})
304
- branches.append(
305
- SequenceBranch(
306
- _text(branch["condition"]),
307
- _references(branch["references"]),
308
- parse_steps(branch["steps"], depth + 1),
304
+ source, target = (
305
+ _field(message, "source", _identifier),
306
+ _field(message, "target", _identifier),
307
+ )
308
+ message_type = message["message_type"]
309
+ if source not in identifiers or target not in identifiers:
310
+ raise DiagramError(
311
+ "diagram message has an unknown endpoint",
312
+ path="/source" if source not in identifiers else "/target",
313
+ )
314
+ if message_type not in ("call", "return"):
315
+ raise DiagramError("diagram message type is invalid", path="/message_type")
316
+ messages += 1
317
+ if messages > 16:
318
+ raise DiagramError("diagram exceeds its total message budget")
319
+ steps.append(
320
+ SequenceMessage(
321
+ source,
322
+ target,
323
+ message_type,
324
+ _field(message, "label", _text),
325
+ _field(message, "references", _references),
309
326
  )
310
327
  )
311
- steps.append(SequenceAlt(tuple(branches)))
312
- else:
313
- raise DiagramError("diagram sequence step kind is invalid")
328
+ elif item.get("kind") == "alt":
329
+ alternative = _object(item, {"kind", "branches"})
330
+ alternatives += 1
331
+ if alternatives > 4 or depth >= 2:
332
+ raise DiagramError(
333
+ "diagram exceeds its total alternative or nesting budget"
334
+ )
335
+ branches = []
336
+ for item_index, branch_item in enumerate(
337
+ _field(alternative, "branches", lambda v: _array(v, 2, 2))
338
+ ):
339
+ with at_pointer(f"/branches/{item_index}"):
340
+ branch = _object(branch_item, {"condition", "references", "steps"})
341
+ branches.append(
342
+ SequenceBranch(
343
+ _field(branch, "condition", _text),
344
+ _field(branch, "references", _references),
345
+ _field(branch, "steps", lambda v: parse_steps(v, depth + 1)),
346
+ )
347
+ )
348
+ steps.append(SequenceAlt(tuple(branches)))
349
+ else:
350
+ raise DiagramError("diagram sequence step kind is invalid", path="/kind")
314
351
  return tuple(steps)
315
352
 
316
- steps = parse_steps(raw["steps"], 0)
353
+ steps = _field(raw, "steps", lambda v: parse_steps(v, 0))
317
354
  if not messages:
318
- raise DiagramError("diagram sequence has no messages")
355
+ raise DiagramError("diagram sequence has no messages", path="/steps")
319
356
  return SequenceDiagram(normalized_participants, steps)
320
357
 
321
358
 
@@ -338,7 +375,7 @@ def parse_submission(value: object, *, expected_range: ReviewRange) -> DiagramSu
338
375
 
339
376
  bounded_json(value)
340
377
  if not isinstance(value, dict) or value.get("state") not in ("generated", "not-applicable"):
341
- raise DiagramError("diagram submission state is invalid")
378
+ raise DiagramError("diagram submission state is invalid", path="/state")
342
379
  generated = value["state"] == "generated"
343
380
  raw = _object(
344
381
  value,
@@ -351,18 +388,22 @@ def parse_submission(value: object, *, expected_range: ReviewRange) -> DiagramSu
351
388
  except OcrResultContractError as exc:
352
389
  raise DiagramError("diagram immutable range is invalid") from exc
353
390
  if review_range != expected_range:
354
- raise DiagramError("diagram refers to a different immutable range")
391
+ raise DiagramError(
392
+ "diagram refers to a different immutable range",
393
+ path="/base_sha" if review_range.base != expected_range.base else "/head_sha",
394
+ )
355
395
  if not generated:
356
396
  return DiagramSubmission(review_range, None)
357
397
  diagram = raw["diagram"]
358
398
  if not isinstance(diagram, dict):
359
- raise DiagramError("diagram variant must be an object")
360
- if diagram.get("kind") == "flowchart":
361
- parsed: Diagram = _flowchart(diagram)
362
- elif diagram.get("kind") == "sequence":
363
- parsed = _sequence(diagram)
364
- else:
365
- raise DiagramError("diagram variant is unsupported")
399
+ raise DiagramError("diagram variant must be an object", path="/diagram")
400
+ with at_pointer("/diagram"):
401
+ if diagram.get("kind") == "flowchart":
402
+ parsed: Diagram = _flowchart(diagram)
403
+ elif diagram.get("kind") == "sequence":
404
+ parsed = _sequence(diagram)
405
+ else:
406
+ raise DiagramError("diagram variant is unsupported", path="/kind")
366
407
  return DiagramSubmission(review_range, parsed)
367
408
 
368
409