open-code-review-toolkit 0.14.6__tar.gz → 0.14.7__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 (186) hide show
  1. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/PKG-INFO +2 -2
  2. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/README.md +1 -1
  3. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/_version.py +2 -2
  4. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/cli.py +7 -1
  5. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/collector.py +29 -7
  6. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/contracts.py +143 -102
  7. open_code_review_toolkit-0.14.7/src/ocr_toolkit/diagrams/diagnostics.py +131 -0
  8. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/lifecycle.py +11 -3
  9. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/mcp.py +38 -44
  10. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/project.py +12 -8
  11. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/native_capabilities.py +1 -0
  12. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/preflight.py +2 -1
  13. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/review_debug.py +38 -1
  14. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/review_runner.py +2 -0
  15. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/review_trace.py +32 -1
  16. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/.gitignore +0 -0
  17. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/LICENSE +0 -0
  18. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/pyproject.toml +0 -0
  19. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/__init__.py +0 -0
  20. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/__init__.py +0 -0
  21. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/filesystem.py +0 -0
  22. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/git.py +0 -0
  23. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/language.py +0 -0
  24. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/literal_context.py +0 -0
  25. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/markdown.py +0 -0
  26. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/redaction.py +0 -0
  27. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/common/value_boundaries.py +0 -0
  28. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/config_writer.py +0 -0
  29. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/configure.py +0 -0
  30. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/__init__.py +0 -0
  31. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/broker.py +0 -0
  32. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/ci_outcomes.py +0 -0
  33. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/code_text.py +0 -0
  34. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/contracts.py +0 -0
  35. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/__init__.py +0 -0
  36. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/admission.py +0 -0
  37. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/credentials.py +0 -0
  38. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/datetimes.py +0 -0
  39. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/decoding.py +0 -0
  40. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/email.py +0 -0
  41. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/markup.py +0 -0
  42. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/numeric.py +0 -0
  43. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/presentation.py +0 -0
  44. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/projection.py +0 -0
  45. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/dlp/result_prose.py +0 -0
  46. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/mcp.py +0 -0
  47. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/policy.py +0 -0
  48. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/recognizers.py +0 -0
  49. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/context/store.py +0 -0
  50. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/__init__.py +0 -0
  51. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/admission.py +0 -0
  52. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/persistence.py +0 -0
  53. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/diagrams/sources.py +0 -0
  54. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/__init__.py +0 -0
  55. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/__main__.py +0 -0
  56. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/cli.py +0 -0
  57. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/corpus.py +0 -0
  58. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/limits.py +0 -0
  59. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/proof.py +0 -0
  60. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/report.py +0 -0
  61. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/scanner.py +0 -0
  62. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/state.py +0 -0
  63. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/dlp_audit/worker_process.py +0 -0
  64. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/__init__.py +0 -0
  65. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/__main__.py +0 -0
  66. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/actions.py +0 -0
  67. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/artifacts.py +0 -0
  68. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/categorize.py +0 -0
  69. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/collect.py +0 -0
  70. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/collectors/__init__.py +0 -0
  71. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/collectors/graphs.py +0 -0
  72. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/collectors/orchestration.py +0 -0
  73. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/collectors/projections.py +0 -0
  74. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/collectors/registry.py +0 -0
  75. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/collectors/sources.py +0 -0
  76. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/coverage.py +0 -0
  77. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/__init__.py +0 -0
  78. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/ansible/__init__.py +0 -0
  79. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/ansible/requirements.py +0 -0
  80. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/ansible/topology.py +0 -0
  81. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/contracts.py +0 -0
  82. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/go.py +0 -0
  83. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/javascript.py +0 -0
  84. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/php.py +0 -0
  85. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/ecosystems/python.py +0 -0
  86. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/__init__.py +0 -0
  87. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/contracts.py +0 -0
  88. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/detection.py +0 -0
  89. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/providers/__init__.py +0 -0
  90. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/providers/frontend.py +0 -0
  91. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/providers/go.py +0 -0
  92. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/providers/php.py +0 -0
  93. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/providers/python.py +0 -0
  94. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/registry.py +0 -0
  95. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/schema.py +0 -0
  96. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/frameworks/templates.py +0 -0
  97. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/gitlink_projection.py +0 -0
  98. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/gitlinks.py +0 -0
  99. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/infrastructure.py +0 -0
  100. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/invocation.py +0 -0
  101. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/mcp.py +0 -0
  102. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/model.py +0 -0
  103. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/opaque_code.py +0 -0
  104. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/policy/__init__.py +0 -0
  105. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/policy/contracts.py +0 -0
  106. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/policy/decisions.py +0 -0
  107. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/policy/guidance.py +0 -0
  108. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/policy/registry.py +0 -0
  109. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/policy/schema.py +0 -0
  110. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/policy/scopes.py +0 -0
  111. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/repository.py +0 -0
  112. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/review_context.py +0 -0
  113. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/review_range.py +0 -0
  114. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/source_reader.py +0 -0
  115. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/source_syntax.py +0 -0
  116. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/store/__init__.py +0 -0
  117. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/store/atomic.py +0 -0
  118. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/store/contracts.py +0 -0
  119. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/store/core.py +0 -0
  120. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/store/readback.py +0 -0
  121. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/store/values.py +0 -0
  122. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/text_contracts.py +0 -0
  123. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/text_excerpts.py +0 -0
  124. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/evidence/text_metadata.py +0 -0
  125. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/__init__.py +0 -0
  126. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/admission.py +0 -0
  127. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/contracts.py +0 -0
  128. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/gateway.py +0 -0
  129. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/registry.py +0 -0
  130. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/relay.py +0 -0
  131. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/runtime.py +0 -0
  132. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/federation/transport.py +0 -0
  133. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/local_chatgpt.py +0 -0
  134. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/mcp_config.py +0 -0
  135. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/ocr_result.py +0 -0
  136. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/__init__.py +0 -0
  137. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/__main__.py +0 -0
  138. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/approval.py +0 -0
  139. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/comments.py +0 -0
  140. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/formatting.py +0 -0
  141. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/freshness.py +0 -0
  142. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/gitlab.py +0 -0
  143. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/gitlab_approval.py +0 -0
  144. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/markers.py +0 -0
  145. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/payloads.py +0 -0
  146. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/reconciliation.py +0 -0
  147. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/result.py +0 -0
  148. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/settings.py +0 -0
  149. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/snapshot.py +0 -0
  150. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/source_suggestions.py +0 -0
  151. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/suggestions.py +0 -0
  152. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/transaction.py +0 -0
  153. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/posting/workflow.py +0 -0
  154. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/pre_execution.py +0 -0
  155. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/provider_config.py +0 -0
  156. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/provider_failure.py +0 -0
  157. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/__init__.py +0 -0
  158. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/gitlab.py +0 -0
  159. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/gitlab_ci.py +0 -0
  160. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/gitlab_context.py +0 -0
  161. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/gitlab_discussions.py +0 -0
  162. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/gitlab_identity.py +0 -0
  163. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/gitlab_remediation.py +0 -0
  164. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/local.py +0 -0
  165. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/providers/local_config.py +0 -0
  166. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/py.typed +0 -0
  167. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/__init__.py +0 -0
  168. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/diagram.py +0 -0
  169. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/diagram_layout.py +0 -0
  170. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/dlp.py +0 -0
  171. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/federation.py +0 -0
  172. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/metadata.py +0 -0
  173. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/model.py +0 -0
  174. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/outcome.py +0 -0
  175. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/result.py +0 -0
  176. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/sections.py +0 -0
  177. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/text.py +0 -0
  178. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/usage.py +0 -0
  179. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/reporting/warnings.py +0 -0
  180. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/repository_coverage.py +0 -0
  181. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/result_contract.py +0 -0
  182. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/result_usage.py +0 -0
  183. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/review_identity.py +0 -0
  184. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/review_progress.py +0 -0
  185. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/src/ocr_toolkit/review_range.py +0 -0
  186. {open_code_review_toolkit-0.14.6 → open_code_review_toolkit-0.14.7}/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.7
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.7'
22
+ __version_tuple__ = version_tuple = (0, 14, 7)
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.")
@@ -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
 
@@ -0,0 +1,131 @@
1
+ """Closed validation feedback: structural locations, never rejected material."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import re
7
+ from collections.abc import Iterator
8
+ from contextlib import contextmanager
9
+
10
+ MAX_DIAGNOSTIC_BYTES = 1024
11
+ MESSAGES = {
12
+ "invalid": "diagram validation failed",
13
+ "state": "diagram submission state is invalid",
14
+ "shape": "diagram object has an invalid closed shape",
15
+ "array": "diagram array exceeds its item budget",
16
+ "text": "diagram text is not bounded single-line text",
17
+ "text_bytes": "diagram text exceeds its UTF-8 byte budget",
18
+ "text_form": "diagram text is empty or noncanonical",
19
+ "identifier": "diagram identifier is invalid",
20
+ "reference_path": "diagram source path is not normalized and relative",
21
+ "reference_span": "diagram source span is invalid",
22
+ "duplicate_reference": "diagram source references are duplicated",
23
+ "duplicate_identifier": "diagram identifiers are duplicated",
24
+ "node_kind": "diagram node kind is invalid",
25
+ "edge_endpoint": "diagram edge has an unknown endpoint",
26
+ "duplicate_edge": "diagram edges are duplicated",
27
+ "sequence_object": "diagram sequence step must be an object",
28
+ "message_endpoint": "diagram message has an unknown endpoint",
29
+ "message_type": "diagram message type is invalid",
30
+ "message_budget": "diagram exceeds its total message budget",
31
+ "alternative_budget": "diagram exceeds its total alternative or nesting budget",
32
+ "step_kind": "diagram sequence step kind is invalid",
33
+ "empty_sequence": "diagram sequence has no messages",
34
+ "json": "diagram is not bounded UTF-8 JSON",
35
+ "diagram_budget": "diagram exceeds its byte budget",
36
+ "range": "diagram immutable range is invalid",
37
+ "range_mismatch": "diagram refers to a different immutable range",
38
+ "variant_object": "diagram variant must be an object",
39
+ "variant": "diagram variant is unsupported",
40
+ }
41
+ _CODES = {message: code for code, message in MESSAGES.items()}
42
+ _FIELDS = frozenset(
43
+ [
44
+ "state",
45
+ "base_sha",
46
+ "head_sha",
47
+ "diagram",
48
+ "kind",
49
+ "nodes",
50
+ "edges",
51
+ "id",
52
+ "label",
53
+ "references",
54
+ "source",
55
+ "target",
56
+ "condition",
57
+ "participants",
58
+ "steps",
59
+ "branches",
60
+ "message_type",
61
+ "path",
62
+ "start_line",
63
+ "end_line",
64
+ ]
65
+ )
66
+ _ENUMS = {
67
+ "state": ("generated", "not-applicable"),
68
+ "node_kind": ("step", "decision"),
69
+ "message_type": ("call", "return"),
70
+ "step_kind": ("message", "alt"),
71
+ "variant": ("flowchart", "sequence"),
72
+ }
73
+ _POINTER = re.compile(r"(?:/(?:" + "|".join(sorted(_FIELDS)) + r"|0|[1-9][0-9]{0,5}))*\Z")
74
+
75
+
76
+ class DiagramError(ValueError):
77
+ """Keep ordinary internal exceptions separate from closed model feedback."""
78
+
79
+ def __init__(self, message: str, *, path: str = "", allowed: tuple[str, ...] = ()) -> None:
80
+ super().__init__(message)
81
+ self.code = _CODES.get(message, "invalid")
82
+ self.path = path
83
+ self.allowed = _ENUMS.get(self.code, allowed if self.code == "shape" else ())
84
+
85
+ def diagnostic(self) -> dict[str, object]:
86
+ """Produce an exact bounded payload; arbitrary exception text is excluded."""
87
+
88
+ value = {
89
+ "code": self.code,
90
+ "path": self.path,
91
+ "message": MESSAGES[self.code],
92
+ "allowed": list(self.allowed),
93
+ }
94
+ return parse_diagnostic(value)
95
+
96
+
97
+ def parse_diagnostic(value: object) -> dict[str, object]:
98
+ """Revalidate private diagnostic state without reflecting hostile values."""
99
+
100
+ if not isinstance(value, dict) or set(value) != {"code", "path", "message", "allowed"}:
101
+ raise DiagramError("diagram validation failed")
102
+ code, path, allowed = value["code"], value["path"], value["allowed"]
103
+ if (
104
+ not isinstance(code, str)
105
+ or code not in MESSAGES
106
+ or value["message"] != MESSAGES[code]
107
+ or not isinstance(path, str)
108
+ or len(path) > 256
109
+ or _POINTER.fullmatch(path) is None
110
+ or not isinstance(allowed, list)
111
+ or len(allowed) > len(_FIELDS)
112
+ or any(not isinstance(item, str) for item in allowed)
113
+ or len(set(allowed)) != len(allowed)
114
+ or (code == "shape" and not set(allowed) <= _FIELDS)
115
+ or (code != "shape" and allowed != list(_ENUMS.get(code, ())))
116
+ ):
117
+ raise DiagramError("diagram validation failed")
118
+ encoded = json.dumps(value, ensure_ascii=False, allow_nan=False).encode("utf-8")
119
+ if len(encoded) > MAX_DIAGNOSTIC_BYTES:
120
+ raise DiagramError("diagram validation failed")
121
+ return {"code": code, "path": path, "message": MESSAGES[code], "allowed": list(allowed)}
122
+
123
+
124
+ @contextmanager
125
+ def at_pointer(pointer: str) -> Iterator[None]:
126
+ """Add a parser-owned field/index location while retaining the closed cause."""
127
+
128
+ try:
129
+ yield
130
+ except DiagramError as exc:
131
+ raise DiagramError(str(exc), path=pointer + exc.path, allowed=exc.allowed) from None
@@ -17,16 +17,21 @@ from ocr_toolkit.diagrams.contracts import (
17
17
  ReferenceSourceInfo,
18
18
  diagram_requested,
19
19
  )
20
+ from ocr_toolkit.diagrams.diagnostics import parse_diagnostic
20
21
  from ocr_toolkit.diagrams.persistence import diagram_payload, parse_diagram_payload
21
22
  from ocr_toolkit.native_capabilities import supports_native_capability
22
23
  from ocr_toolkit.review_range import ReviewRange
23
24
 
24
25
 
25
- def diagram_warning() -> None:
26
+ def diagram_warning(diagnostic: dict[str, object] | None = None) -> None:
26
27
  """Log a closed notice without rejected content or exception details."""
27
28
 
28
29
  try:
29
- print("OCR diagram unavailable or invalid; review continues without it.", file=sys.stderr)
30
+ message = "OCR diagram unavailable or invalid; review continues without it."
31
+ if diagnostic is not None:
32
+ safe = parse_diagnostic(diagnostic)
33
+ message = f"OCR diagram omitted: {safe['code']} at {safe['path'] or '/'}; review continues without it."
34
+ print(message, file=sys.stderr)
30
35
  except Exception:
31
36
  pass
32
37
 
@@ -125,5 +130,8 @@ class DiagramExecution:
125
130
  )
126
131
  self.result = result
127
132
  if result.state in {"omitted-invalid", "not-generated", "unsupported"}:
128
- diagram_warning()
133
+ if result.reason == "invalid" and self.snapshot is not None:
134
+ diagram_warning(self.snapshot.last_error)
135
+ else:
136
+ diagram_warning()
129
137
  return result